github.com/npaton/distribution@v2.3.1-rc.0+incompatible/docs/index.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Docker Registry"
     4  description = "High-level overview of the Registry"
     5  keywords = ["registry, on-prem, images, tags, repository, distribution"]
     6  [menu.main]
     7  parent="smn_registry"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # Docker Registry
    12  
    13  ## What it is
    14  
    15  The Registry is a stateless, highly scalable server side application that stores and lets you distribute Docker images.
    16  The Registry is open-source, under the permissive [Apache license](http://en.wikipedia.org/wiki/Apache_License).
    17  
    18  ## Why use it
    19  
    20  You should use the Registry if you want to:
    21  
    22   * tightly control where your images are being stored
    23   * fully own your images distribution pipeline
    24   * integrate image storage and distribution tightly into your in-house development workflow
    25  
    26  ## Alternatives
    27  
    28  Users looking for a zero maintenance, ready-to-go solution are encouraged to head-over to the [Docker Hub](https://hub.docker.com), which provides a free-to-use, hosted Registry, plus additional features (organization accounts, automated builds, and more).
    29  
    30  Users looking for a commercially supported version of the Registry should look into [Docker Trusted Registry](https://docs.docker.com/docker-trusted-registry/).
    31  
    32  ## Requirements
    33  
    34  The Registry is compatible with Docker engine **version 1.6.0 or higher**.
    35  If you really need to work with older Docker versions, you should look into the [old python registry](https://github.com/docker/docker-registry).
    36  
    37  ## TL;DR
    38  
    39  Start your registry
    40  
    41      docker run -d -p 5000:5000 --name registry registry:2
    42  
    43  Pull (or build) some image from the hub
    44  
    45      docker pull ubuntu
    46  
    47  Tag the image so that it points to your registry
    48  
    49      docker tag ubuntu localhost:5000/myfirstimage
    50  
    51  Push it
    52  
    53      docker push localhost:5000/myfirstimage
    54  
    55  Pull it back
    56  
    57      docker pull localhost:5000/myfirstimage
    58  
    59  Now stop your registry and remove all data
    60  
    61      docker stop registry && docker rm -v registry
    62  
    63  ## Next
    64  
    65  You should now read the [detailed introduction about the registry](introduction.md), or jump directly to [deployment instructions](deploying.md).
    66