Save registry credentials

DockerHub (registry.hub.docker.com)

Enter your Docker Hub username and password, or use a personal access token with read access. If your account uses two-factor authentication, use a token.

Cloud provider registries

Use a cloud integration to connect ECR, Google Artifact Registry, or Azure Container Registry. Select Docker Registries in the integration and grant the corresponding cloud permissions.

In the registry form, select your provider and integration. Enter the registry URL and its region, Google project ID, or Azure resource group.

To use these credentials for project builds, also select Docker Registry Push in the integration. Grant the required cloud permissions, then enable Push access (write images) in the registry form.

See add a custom Docker registry for URL examples and project setup.

GitHub Container Registry (ghcr.io)

Enter your GitHub username and a personal access token (classic) with the read:packages permission. Create the token under Developer settings in your GitHub account. See GitHub's registry authentication guide for package access requirements.

GitLab (registry.gitlab.com)

Enter your GitLab username and a personal access token with the read_registry permission. See GitLab's registry authentication guide for details.

For a self-hosted GitLab instance, use its registry domain for both saved credentials and image paths.

Custom registries

For another registry, select Custom container registry and enter its URL, username, and password or token. Use this option for a self-hosted GitLab registry with its own domain.

Registry troubleshooting

The registry form accepts a username and password or token. It does not accept a complete Docker config.json file.

If you already use Docker credentials, enter the original username and password or token in the registry form. Do not enter the Base64-encoded auth value as the password.

For API requests, send credentials as JSON to POST /v1/integrations/registries. For example:

{
  "name": "example-registry",
  "provider": "custom",
  "registryUrl": "https://registry.example.com",
  "credentials": {
    "username": "example-user",
    "password": "your-password-or-token",
    "scope": {
      "pull": true,
      "push": false
    }
  }
}

Replace the example values with your registry credentials. For cloud registries, follow the cloud integration instructions.