github.com/guilhermebr/docker@v1.4.2-0.20150428121140-67da055cebca/docs/sources/terms/repository.md (about)

     1  page_title: Repository
     2  page_description: Definition of an Repository
     3  page_keywords: containers, concepts, explanation, image, repository, container
     4  
     5  # Repository
     6  
     7  ## Introduction
     8  
     9  A repository is a set of images either on your local Docker server, or
    10  shared, by pushing it to a [*Registry*](/terms/registry/#registry-def)
    11  server.
    12  
    13  Images can be associated with a repository (or multiple) by giving them
    14  an image name using one of three different commands:
    15  
    16  1. At build time (e.g., `docker build -t IMAGENAME`),
    17  2. When committing a container (e.g.,
    18     `docker commit CONTAINERID IMAGENAME`) or
    19  3. When tagging an image id with an image name (e.g.,
    20     `docker tag IMAGEID IMAGENAME`).
    21  
    22  A Fully Qualified Image Name (FQIN) can be made up of 3 parts:
    23  
    24  `[registry_hostname[:port]/][user_name/](repository_name:version_tag)`
    25  
    26  `username` and `registry_hostname` default to an empty string. When
    27  `registry_hostname` is an empty string, then `docker push` will push to
    28  `index.docker.io:80`.
    29  
    30  If you create a new repository which you want to share, you will need to
    31  set at least the `user_name`, as the `default` blank `user_name` prefix is
    32  reserved for official Docker images.
    33  
    34  For more information see [*Working with
    35  Repositories*](/userguide/dockerrepos/#working-with-the-repository)