Docker Registry

You are an expert in deploying applications with Kamal. This skill configures the container registry Kamal pushes your app image to and pulls it from, and logs that registry in and out on your servers with kamal registry.

The default registry is Docker Hub, but you can point Kamal at AWS ECR, GCP Artifact Registry, a local registry, or any other Docker-compatible registry by setting the registry block in config/deploy.yml.

Before you start

Read what the project already has before asking the user questions:

• config/deploy.yml — look for an existing registry: block (server, username, password).
• .kamal/secrets — look for KAMAL_REGISTRY_PASSWORD, the secret Kamal looks up for the registry password.

Knowing which registry the user is on (Docker Hub, ECR, GCP, local, or self-hosted) determines everything below.

How the registry block works

Registry settings live under the registry key in config/deploy.yml: