Skip to main content
Version: 9.x

Azure Container Registry (ACR)

🔐 Setup Required

The acr registry module lets you authenticate against Azure Container Registry (ACR) instances.

⚙️ Configuration Variables​

WUD_REGISTRY_ACR_{registry_name}_CLIENTID
Requiredstring

Azure Service Principal Application (Client) ID

Allowed values:Valid Azure Service Principal Application (Client) ID UUID
WUD_REGISTRY_ACR_{registry_name}_CLIENTSECRET
Requiredstring

Azure Service Principal Client Secret

Allowed values:Valid Azure Service Principal Client Secret
WUD_REGISTRY_ACR_{registry_name}_NAME
Optionalstringdefault: {registry_name}.azurecr.io

Registry domain name (e.g. myregistry.azurecr.io)

Allowed values:Full registry domain name
Required Permissions

Ensure your Azure Service Principal is assigned the AcrPull role on the target Container Registry. See Azure Service Principal Authentication.

🚀 Examples​

Authenticate with an Azure Container Registry​

services:
  whatsupdocker:
    image: getwud/wud
    environment:
      - WUD_REGISTRY_ACR_MYREGISTRY_CLIENTID=00000000-0000-0000-0000-000000000000
      - WUD_REGISTRY_ACR_MYREGISTRY_CLIENTSECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

📖 Setup Guide: Creating Azure Service Principal Credentials​

1. Create a Service Principal​

Follow the official Azure guide to register an application and generate a client secret in Microsoft Entra ID.

Azure portal register application

2. Open Access Control (IAM)​

Navigate to your Container Registry in the Azure Portal and select Access Control (IAM).

Azure portal access control

3. Assign the AcrPull Role​

Click Add role assignment, select the AcrPull role, and assign it to your newly created Service Principal.

Azure portal add role assignment