> ## Documentation Index
> Fetch the complete documentation index at: https://controlplanecorporation-majid-docs-content-expansion.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure ACR

> Enable Managed Kubernetes clusters to pull container images from private Azure Container Registry instances.

## Overview

The Azure ACR add-on facilitates access to [Azure ACR](https://azure.microsoft.com/en-us/products/container-registry) for managed Kubernetes clusters.

## Supported Providers

* All providers are supported

## Prerequisites

* The [Azure Workload Identity](/mk8s/add-ons/azure_workload_identity) add-on must be enabled for your cluster.

## How to Enable

You can enable the Azure ACR add-on for your Kubernetes cluster either during the cluster creation process or at any time afterwards. The add-on requires the client ID of the Azure workload identity that has pull access to your registry.

### At Cluster Creation

* **Through Cluster Manifest**: Add the following snippet to your cluster manifest when creating the cluster:

  ```yaml YAML theme={null}
  spec:
    ...
    addOns:
      azureACR:
        clientId: 11112222-3333-4444-5555-666677778888
    ...
  ```

* **Using the Console**: If you're creating the cluster through the console, navigate to `Add-ons`, find the `Azure ACR` add-on in the list of available add-ons, toggle it on, and enter the client ID.

### After Cluster Creation

If the Azure ACR add-on was not enabled during the cluster creation, you can still enable it using the following methods:

* **Direct Edit & Apply**: Navigate to your cluster in the Console, use the `Edit & Apply` option, and add the manifest snippet above.
* **CLI**: Add the snippet to your cluster manifest and apply it with `cpln apply`.
* **Using the Console**: Navigate to `Add-ons` of your cluster, find the `Azure ACR` add-on, toggle it on, and enter the client ID.