moby--moby/docs/terms/repository.md

<!--[metadata]>
+++
draft = true
title = "Repository"
description = "Definition of an Repository"
keywords = ["containers, concepts, explanation, image, repository,  container"]
[menu.main]
parent = "identifier"
+++
<![end-metadata]-->

# Repository

## Introduction

A repository is a set of images either on your local Docker server, or
shared, by pushing it to a [*Registry*](/terms/registry/#registry-def)
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 Repositories](/docker-hub/official_repos).

For more information see [*Working with
Repositories*](/userguide/dockerrepos/#working-with-the-repository)