github.com/jogo/docker@v1.7.0-rc1/docs/sources/docker-hub/userguide.md (about)

     1  page_title: Docker Hub user guide
     2  page_description: Docker Hub user guide
     3  page_keywords: Docker, docker, registry, Docker Hub, docs, documentation
     4  
     5  # Using the Docker Hub
     6  
     7  Docker Hub is used to find and pull Docker images to run or build upon, and to
     8  distribute and build images for other users to use.
     9  
    10  ![your profile](/docker-hub/hub-images/dashboard.png)
    11  
    12  ## Finding repositories and images
    13  
    14  There are two ways you can search for public repositories and images available
    15  on the Docker Hub. You can use the "Search" tool on the Docker Hub website, or
    16  you can `search` for all the repositories and images using the Docker commandline
    17  tool:
    18  
    19      $ docker search ubuntu
    20  
    21  Both will show you a list of the currently available public repositories on the
    22  Docker Hub which match the provided keyword.
    23  
    24  If a repository is private or marked as unlisted, it won't be in the repository
    25  search results. To see all the repositories you have access to and their statuses,
    26  you can look at your profile page on [Docker Hub](https://hub.docker.com).
    27  
    28  ## Pulling, running and building images
    29  
    30  You can find more information on [working with Docker images](../userguide/dockerimages.md).
    31  
    32  ## Official Repositories
    33  
    34  The Docker Hub contains a number of [Official
    35  Repositories](http://registry.hub.docker.com/official). These are
    36  certified repositories from vendors and contributors to Docker. They
    37  contain Docker images from vendors like Canonical, Oracle, and Red Hat
    38  that you can use to build applications and services.
    39  
    40  If you use Official Repositories you know you're using an optimized and
    41  up-to-date image to power your applications.
    42  
    43  > **Note:**
    44  > If you would like to contribute an Official Repository for your
    45  > organization, see [Official Repositories on Docker
    46  > Hub](/docker-hub/official_repos) for more information.
    47  
    48  ## Building and shipping your own repositories and images
    49  
    50  The Docker Hub provides you and your team with a place to build and ship Docker images.
    51  
    52  Collections of Docker images are managed using repositories - 
    53  
    54  You can configure two types of repositories to manage on the Docker Hub:
    55  [Repositories](./repos.md), which allow you to push images to the Hub from your local Docker daemon,
    56  and [Automated Builds](./builds.md), which allow you to configure GitHub or Bitbucket to
    57  trigger the Hub to rebuild repositories when changes are made to the repository.