Skip to content
Microsoft Container Registry description and related FAQ
Branch: master
Clone or download

Latest commit

Latest commit 1a45ff6 Mar 17, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
media Add MCR client firewall rules Feb 4, 2020
.gitignore Initial commit May 10, 2019
LICENSE Initial commit May 10, 2019
LICENSE-CODE Initial commit May 10, 2019 Remove contributing content as this repo doesn't have any oss content. Mar 2, 2020 PR Feedback Mar 16, 2020

Microsoft Container Registry (MCR)

See Client Firewall Rules for an important change on March 3, 2020

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.

Browsing MCR Content

The discovery experience for MCR is provided through dockerhub.

For more background on 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.

You can’t perform that action at this time.