March 17, 2025

AWS ECR Private Registry Support in Gitpod

We’re excited to announce that Gitpod now supports AWS ECR private registries with IAM-based authentication when using AWS EC2 runners.

With this new feature, you can:

• Securely access private ECR repositories without manually managing credentials
• Simplify authentication workflows using EC2 runner’s IAM role
• Seamlessly work with private container images in your development environment

This native integration works automatically when:

1. You’re using AWS EC2 runners for your environments
2. Your ECR registry and EC2 runners are in the same AWS account (or have appropriate cross-account access)

Setting up ECR registry access is straightforward through the Project Secrets interface. Simply select Container Registry Basic Auth, enter your ECR registry hostname, and the system will automatically configure runner-native authentication.

Learn how to configure IAM permissions and set up your ECR registry in our documentation.