Create a zone-redundant replica in Azure Container Registry

Sign in to the Azure portal.

Go to your Premium tier container registry, and select Geo-replications.

On the map that appears, you do one of the following:

• Select a green hexagon in a region that supports availability zones, such as West US 2.

• Select + Add.

In the Create replication window, confirm the Location.

In Availability zones, select Enabled, and then select Create.

Make sure that you have Azure CLI version 2.17.0 or later, or Azure Cloud Shell. If you need to install or upgrade, see Install Azure CLI.

Create zone-redundant replication by running az acr replication create (replace <resource-group-name>, <container-registry-name>, and <replica-region> with your values):

az acr replication create \
  --location <region-name> \
  --resource-group <resource-group-name> \
  --registry <container-registry-name> \
  --zone-redundancy enabled

In the command output, note the zoneRedundancy property for the replica. When zoneRedundancy is set to "Enabled", the registry is zone redundant:

{
  [...]
  "zoneRedundancy": "Enabled"
}

To create a geo-replica for your existing registry, copy the following Bicep template to a new file and save it using a filename such as replicaZone.bicep.

By default, the template enables zone redundancy the regional replica.

@description('Globally unique name of your Azure Container Registry')
param containerRegistryName string

@description('Short name for registry replica location, such as australiaeast or westus.')
param replicaLocation string

@description('Enable zone redundancy of registry replica. Requires replica location to support availability zones.')
@allowed([
  'Enabled'
  'Disabled'
])
param replicaZoneRedundancy string = 'Enabled'

resource containerRegistry 'Microsoft.ContainerRegistry/registries@2025-04-01' existing = {
  name: containerRegistryName
}

resource containerRegistryReplica 'Microsoft.ContainerRegistry/registries/replications@2025-04-01' = {
  parent: containerRegistry
  name: replicaLocation
  location: replicaLocation
  properties: {
    zoneRedundancy: replicaZoneRedundancy
  }
}

Run the following az deployment group create command to create the registry using the preceding template file (replace <resource-group-name>, <registry-name>, and <replica-location> with your values).

az deployment group create \
  --resource-group <resource-group-name> \
  --template-file registryZone.json \
  --parameters containerRegistryName=<registry-name> replicaLocation=<replica-location>