Microsoft Artifact Registry (MAR)

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

For more background on MAR:

• Microsoft syndicates container catalog (mcr.microsoft.com)
• Improved discovery experience for Microsoft containers on Docker Hub

Browsing MAR Content

The discovery experience for MAR is provided through the MAR discovery UI on mcr.microsoft.com and Docker Hub.

1. To browse the list of repositories within MAR, visit https://mcr.microsoft.com/

2. To browse the list of tags, within a repository:

   a. Visit https://mcr.microsoft.com/

   b. Select an artifact from the catalog listing

   c. Select the Tags tab to view the list of tags for that particular artifact

Additional Guidance for the Use of MAR

• Guidance for using the official MAR endpoints
• Client Firewall Rules
• Consuming Public Content

Providing Feedback

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

FAQ

• What is the difference between MAR and MCR?

  There is no difference, MAR and MCR are the same product offering.

• Will the endpoints change from mcr.microsoft.com to mar.microsoft.com?

  No, all endpoints will use the existing mcr.microsoft.com structure.

• How does MAR work with Docker Hub?

  MAR is a public registry for housing Microsoft's official artifacts (such as container images). Docker Hub is one of the official sources (in addition to https://mcr.microsoft.com) 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 MAR and ACR (Azure Container Registry)?

  MAR is a public registry for housing only Microsoft's official artifacts (such as container images). ACR is a private container registry for housing our customers' container images.

• Can I browse MAR?

  Yes, customers can browse the MAR discovery UI at mcr.microsoft.com. Customers can view rich content like descriptions and tag listings for each artifact.

• Can I Onboard new Images to MAR?

  No, Given that MAR 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 https://go.microsoft.com/fwlink/?LinkID=254653.

Privacy information can be found at https://privacy.microsoft.com/en-us/

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