1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/docs/sources/terms/repository.md
Mary Anthony 29d01b7dde Removing sudo from command line examples
We now advise people to configure docker group and
add to sudo.  Mac shouldn't use sudo.  Removed sudo
from command examples.  Left in installation to be removed
in installation doc sweep -- removing requires finer
grain control.

Signed-off-by: Mary Anthony <mary@docker.com>
2015-03-26 11:12:37 -07:00

1.2 KiB

page_title: Repository page_description: Definition of an Repository page_keywords: containers, concepts, explanation, image, repository, container

Repository

Introduction

A repository is a set of images either on your local Docker server, or shared, by pushing it to a Registry server.

Images can be associated with a repository (or multiple) by giving them an image name using one of three different commands:

  1. At build time (e.g., docker build -t IMAGENAME),
  2. When committing a container (e.g., docker commit CONTAINERID IMAGENAME) or
  3. When tagging an image id with an image name (e.g., docker tag IMAGEID IMAGENAME).

A Fully Qualified Image Name (FQIN) can be made up of 3 parts:

[registry_hostname[:port]/][user_name/](repository_name:version_tag)

username and registry_hostname default to an empty string. When registry_hostname is an empty string, then docker push will push to index.docker.io:80.

If you create a new repository which you want to share, you will need to set at least the user_name, as the default blank user_name prefix is reserved for official Docker images.

For more information see Working with Repositories