Geo-replication in Azure Container Registry

Companies that want a local presence, or a hot backup, choose to run services from multiple Azure regions. As a best practice, placing a container registry in each region where images are run allows network-close operations, enabling fast, reliable image layer transfers. Geo-replication enables an Azure container registry to function as a single registry, serving multiple regions with multi-master regional registries.

A geo-replicated registry provides the following benefits:

  • Single registry/image/tag names can be used across multiple regions
  • Network-close registry access from regional deployments
  • No additional egress fees, as images are pulled from a local, replicated registry in the same region as your container host
  • Single management of a registry across multiple regions

Example use case

Contoso runs a public presence website located across the US, Canada, and Europe. To serve these markets with local and network-close content, Contoso runs Azure Container Service (ACS) Kubernetes clusters in West US, East US, Canada Central, and West Europe. The website application, deployed as a Docker image, utilizes the same code and image across all regions. Content, local to that region, is retrieved from a database, which is provisioned uniquely in each region. Each regional deployment has its unique configuration for resources like the local database.

The development team is located in Seattle WA, utilizing the West US data center.

Pushing to multiple registries
Pushing to multiple registries

Prior to using the geo-replication features, Contoso had a US-based registry in West US, with an additional registry in West Europe. To serve these different regions, the development team had to push images to two different registries.

docker push
docker push

Pulling from multiple registries
Pulling from multiple registries

Typical challenges of multiple registries include:

  • The East US, West US, and Canada Central clusters all pull from the West US registry, incurring egress fees as each of these remote container hosts pull images from West US data centers.
  • The development team must push images to West US and West Europe registries.
  • The development team must configure and maintain each regional deployment with image names referencing the local registry.
  • Registry access must be configured for each region.

Benefits of geo-replication

Pulling from a geo-replicated registry

Using the geo-replication feature of Azure Container Registry, these benefits are realized:

  • Manage a single registry across all regions:
  • Manage a single configuration of image deployments as all regions used the same image URL:
  • Push to a single registry, while ACR manages the geo-replication, including regional webhooks for local notifications

Configure geo-replication

Configuring geo-replication is as easy as clicking regions on a map.

Geo-replication is a feature of Premium registries only. If your registry isn't yet Premium, you can change from Basic and Standard to Premium in the Azure portal:

Switching SKUs in the Azure portal

To configure geo-replication for your Premium registry, log in to the Azure portal at

Navigate to your Azure Container Registry, and select Replications:

Replications in the Azure portal container registry UI

A map is displayed showing all current Azure Regions:

Region map in the Azure portal

  • Blue hexagons represent current replicas
  • Green hexagons represent possible replica regions
  • Gray hexagons represent Azure regions not yet available for replication

To configure a replica, select a green hexagon, then select Create:

Create replication UI in the Azure portal

To configure additional replicas, select the green hexagons for other regions, then click Create.

ACR begins syncing images across the configured replicas. Once complete, the portal reflects Ready. The replica status in the portal doesn't automatically update. Use the refresh button to see the updated status.

Geo-replication pricing

Geo-replication is a feature of the Premium SKU of Azure Container Registry. When you replicate a registry to your desired regions, you incur Premium registry fees for each region.

In the preceding example, Contoso consolidated two registries down to one, adding replicas to East US, Canada Central, and West Europe. Contoso would pay four times Premium per month, with no additional configuration or management. Each region now pulls their images locally, improving performance, reliability without network egress fees from West US to Canada and East US.


With geo-replication, you can manage your regional data centers as one global cloud. As images are used across many Azure services, you can benefit from a single management plane while maintaining network-close, fast, and reliable local image pulls.

Next steps

Check out the three-part tutorial series, Geo-replication in Azure Container Registry. Walk through creating a geo-replicated registry, building a container, and then deploying it with a single docker push command to multiple regional Web Apps for Containers instances.