github.com/circular-dark/docker@v1.7.0/docs/docker-hub/userguide.md (about)

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