Home • Explore • Blog • CI
☰



docker
3rd chunk of `content/manuals/scout/integrations/registry/acr.md`
53adaa4503df62cfed5179c5668fab480d8394d91e7571c00000000100000bcd
{{ transform.Remarshal "json" $data }}
```

{{ end }}
{{< /acr-template.inline >}}

{{< /accordion >}}

## Integrate a registry

1. Go to [ACR integration page](https://scout.docker.com/settings/integrations/azure/) on the
   Docker Scout Dashboard.
2. In the **How to integrate** section, enter the **Registry hostname** of the
   registry you want to integrate.
3. Select **Next**.
4. Select **Deploy to Azure** to open the template deployment wizard in Azure.

   You may be prompted to sign in to your Azure account if you're not already
   signed in.

5. In the template wizard, configure your deployment:

   - **Resource group**: enter the same resource group as you're using for the
     container registry. The Docker Scout resources must be deployed to the
     same resource group as the registry.

   - **Registry name**: the field is pre-filled with the subdomain of the
     registry hostname.

6. Select **Review + create**, and then **Create** to deploy the template.

7. Wait until the deployment is complete.
8. In the **Deployment details** section click on the newly created resource
    of the type **Container registry token**. Generate a new password for this token.
    
    Alternatively, use the search function in Azure to navigate to the
    **Container registry** resource that you're looking to integrate, and
    generate the new password for the created access token.

9. Copy the generated password and head back to the Docker Scout Dashboard to
    finalize the integration.

10. Paste the generated password into the **Registry token** field.
11. Select **Enable integration**.

After selecting **Enable integration**, Docker Scout performs a connection test
to verify the integration. If the verification was successful, you're
redirected to the Azure registry summary page, which shows you all your Azure
integrations for the current organization.

Next, activate Docker Scout for the repositories that you want to analyze in
[Repository settings](https://scout.docker.com/settings/repos/).

After activating repositories, images that you push are analyzed by Docker
Scout. The analysis results appear in the Docker Scout Dashboard.
If your repository already contains images, Docker Scout pulls and analyzes the
latest image version automatically.

## Remove an integration

> [!IMPORTANT]
>
> Removing the integration in the Docker Scout Dashboard doesn't automatically
> remove the resources created in Azure.

To remove an ACR integration:

1. Go to the [ACR integration page](https://scout.docker.com/settings/integrations/azure/)
   on the Docker Scout Dashboard.
2. Find the ACR integration that you want to remove, and select the **Remove**
   button.
3. In the dialog that opens, confirm by selecting **Remove**.
4. After removing the integration in the Docker Scout Dashboard, also remove
   the Azure resources related to the integration:

   - The `docker-scout-readonly-token` token for the container registry.
   - The `docker-scout-repository` Event Grid System Topic.
Title: Integrating and Removing Azure Container Registry (ACR) in Docker Scout
Summary
This section details how to integrate and remove an ACR with Docker Scout. The integration process involves using an ARM template, deploying it via the Azure portal, configuring a registry token, and enabling the integration in the Docker Scout Dashboard. After enabling, Docker Scout analyzes newly pushed images. The removal process involves removing the integration from the Docker Scout Dashboard and then manually deleting associated resources in Azure, such as the registry token and Event Grid System Topic.