Home Explore Blog CI



docker

1st chunk of `content/manuals/scout/integrations/registry/ecr.md`
d99dbb49a790de0834bcb75ef0989965166bd303a3c491e10000000100000840
---
description: Integrate Amazon Elastic Container Registry with Docker Scout
keywords: docker scout, ecr, integration, image analysis, security, cves
title: Integrate Docker Scout with Amazon ECR
linkTitle: Amazon ECR
---

Integrating Docker Scout with Amazon Elastic Container Registry (ECR) lets you
view image insights for images hosted in ECR repositories. After integrating
Docker Scout with ECR and activating Docker Scout for a repository, pushing an
image to the repository automatically triggers image analysis. You can view
image insights using the Docker Scout Dashboard, or the `docker scout` CLI
commands.

## How it works

To help you integrate Docker Scout with ECR, you can use a CloudFormation stack
template that creates and configures the necessary AWS resources for
integrating Docker Scout with your ECR registry. For more details about the AWS
resources, see [CloudFormation stack template](#cloudformation-stack-template).

The following diagram shows how the Docker Scout ECR integration works.



After the integration, Docker Scout automatically pulls and analyzes images
that you push to the ECR registry. Metadata about your images are stored on the
Docker Scout platform, but Docker Scout doesn't store the container images
themselves. For more information about how Docker Scout handles image data, see
[Data handling](/manuals/scout/deep-dive/data-handling.md).

### CloudFormation stack template

The following table describes the configuration resources.

> [!NOTE]
>
> Creating these resources incurs a small, recurring cost on the AWS account.
> The **Cost** column in the table represents an estimated monthly cost of the
> resources, when integrating an ECR registry that gets 100 images pushed per day.
>
> Additionally, an egress cost also applies when Docker Scout pulls the images
> from ECR. The egress cost is around $0.09 per GB.

| Resource type                 | Resource name                 | Description                                                                                | Cost  |

Title: Integrating Docker Scout with Amazon ECR
Summary
Integrating Docker Scout with Amazon Elastic Container Registry (ECR) allows users to view image insights for images hosted in ECR repositories. A CloudFormation stack template is used to create and configure the necessary AWS resources. The integration automatically triggers image analysis upon pushing an image to the repository, and image insights can be viewed using the Docker Scout Dashboard or CLI commands. Docker Scout handles image metadata but doesn't store the container images themselves.