Azure container registry repositories

Azure container registry allows you to store container images in repositories. By storing images in repositories, you can have groups of images (or version of images) in isolated environments. You can specify these repositories when you push images to your registry.


  • Azure container registry - Create a container registry in your Azure subscription. For example, use the Azure portal or the Azure CLI 2.0.
  • Docker CLI - To set up your local computer as a Docker host and access the Docker CLI commands, install Docker Engine.
  • Pull an image - Pull an image from the public Docker Hub registry, tag it, and push it to your registry. For guidance on how push and pull images, see Push Docker image to Azure private registry.

Viewing repositories in the Portal

Once you have pushed images to your container registry, you can see a list of the repositories hosting the images in the Azure portal.

If you followed the steps in the Push Docker image to Azure private registry article, you should now have a Nginx image in your container registry. As part of the instructions, you should have specified a namespace for the image. In the example below, the command pushes the NGinx image to the "samples" repository:

docker push

Azure Container Registry supports multilevel repository namespaces. This feature enables you to group collections of images related to a specific app, or a collection of apps to specific development or operational teams. To read more about repositories in container registries, see Private Docker container registries in Azure.

To view the container registry repositories:

  1. Log in to the Azure portal
  2. On the Azure Container Registry blade, select the registry you wish to inspect
  3. In the registry blade, click Repositories to see a list of all the repositories and their images
  4. (Optional) Select a specific image to see tags

Repositories in the portal

Next steps

Now that you know the basics, you are ready to start using your registry! For example, start deploying container images to an Azure Container Service cluster.