> ## Documentation Index
> Fetch the complete documentation index at: https://www.qovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure Container Registry

> Connect Azure Container Registry (ACR) with Qovery

## Overview

Azure Container Registry (ACR) is a managed container registry service for storing and managing private Docker container images.

## Automatic Registry

When you create a cluster on Azure, Qovery automatically creates a container registry (named `registry-{UUID}`) that is used to manage the deployment of your applications by mirroring Docker images.

The credentials configured on this automatic registry are the ones used to create the cluster, but you can update them if you prefer to manage them separately.

## Adding Your Own ACR

To connect your own Azure Container Registry to Qovery:

### Required Information

<Steps>
  <Step title="Registry URL">
    Format: `https://<registry-name>.azurecr.io`

    Example: `https://mycompany.azurecr.io`
  </Step>

  <Step title="Access Credentials">
    * Registry username (admin username or service principal)
    * Password or service principal secret
  </Step>
</Steps>

### Configuration in Qovery

<Steps>
  <Step title="Access Organization Settings">
    Navigate to **Organization Settings** → **Container Registries**
  </Step>

  <Step title="Add Registry">
    Click **Add Registry**
  </Step>

  <Step title="Select Azure ACR">
    Choose **Azure Container Registry** from the registry type dropdown
  </Step>

  <Step title="Enter Details">
    Provide the registry URL and credentials
  </Step>

  <Step title="Save">
    Qovery will verify the credentials and save the configuration
  </Step>
</Steps>

## Related Resources

<CardGroup cols={2}>
  <Card title="Container Registry Management" icon="box" href="/configuration/organization/container-registry">
    Manage all container registries
  </Card>

  <Card title="Deploy Application" icon="rocket" href="/configuration/application">
    Deploy applications from container images
  </Card>

  <Card title="Azure AKS Setup" icon="https://mintcdn.com/qovery/Nvnl0g5BHzA0XQmy/images/logos/cloud-providers/azure-icon.svg?fit=max&auto=format&n=Nvnl0g5BHzA0XQmy&q=85&s=0d214ad250aa99938f4f1796bb506fb9" href="/configuration/integrations/kubernetes/aks/overview" width="24" height="24" data-path="images/logos/cloud-providers/azure-icon.svg">
    Set up Azure AKS cluster with Qovery
  </Card>

  <Card title="Azure Credentials" icon="key" href="/configuration/organization/cloud-credentials">
    Manage Azure credentials
  </Card>
</CardGroup>
