Skip to content
Switch branches/tags


Failed to load latest commit information.

Microsoft Container Registry (MCR)

Microsoft Container Registry (MCR) is the primary Registry for all Microsoft Published docker images that offers a reliable and trustworthy delivery of container images with a syndicated catalog, while maintaining the quality that customers expect from a Microsoft product offering.

For more background on MCR:

Browsing MCR Content

The discovery experience for MCR is provided through dockerhub.

To query the list of repositories within mcr:

To query the list of tags, within a repository:{namespace/repo}/tags/list
For example, to retrieve the list of tags for mcr/hello-world :

Additional Guidance for the Use of MCR

Providing Feedback

Please open issues to provide your feedback on usage, as well as any suggestions or concerns with MCR.


  • How does MCR work with Dockerhub? MCR is a public registry that houses Microsoft Published images but it does not have its own catalog UI experience. Docker Hub is the official source for our customers to discover official Microsoft-published container images. For further details of this integration please visit our blog

  • What is the difference between MCR and ACR(Azure Container Registry)? MCR is a public registry for housing only Microsoft's official Container images. ACR is a private container registry for housing our customers' container images.

  • Can I browse MCR? No, MCR does not have a UI/discovery experience, the only experience with the registry is for interacting with a container image. Ex: docker pull

  • Can I Onboard new Images to MCR? No, Given that MCR is meant to host only official Microsoft Container Images, only Internal Microsoft Product teams will be able to onboard images to the registry. Once onboarded, the images are available to all public users.

Legal Notices

Microsoft and any contributors grant you a license to the Microsoft documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License, see the LICENSE-CODE file.

Microsoft, Windows, Microsoft Azure and/or other Microsoft products and services referenced in the documentation may be either trademarks or registered trademarks of Microsoft in the United States and/or other countries. The licenses for this project do not grant you rights to use any Microsoft names, logos, or trademarks. Microsoft's general trademark guidelines can be found at

Privacy information can be found at

Microsoft and any contributors reserve all other rights, whether under their respective copyrights, patents, or trademarks, whether by implication, estoppel or otherwise.


Microsoft Container Registry description and related FAQ


Code of conduct





No releases published


No packages published