Skip to main content

Add a Registry

Connect your private container registry in a few steps.

What you need​

  • Registry URL (e.g., docker.io, ghcr.io)
  • Username
  • Access token (not your password)

Steps​

1. Get an access token​

Create a read-only access token from your registry provider:

Docker Hub:

  • Account Settings → Security → New Access Token
  • Set to "Read-only"

GitHub Container Registry:

  • Settings → Developer settings → Personal access tokens
  • Grant read:packages scope

GitLab Container Registry:

  • Project → Settings → Repository → Deploy tokens
  • Enable read_registry scope

AWS ECR / GCR / ACR:

  • Create a service account with read-only permissions
  • Generate credentials following provider documentation

Self-hosted registries:

  • Contact your registry administrator for credentials

2. Add to Thevenin​

  1. Go to Container Registries in Thevenin
  2. Click Add Registry
  3. Fill in:
    • Name: Any name (e.g., "My Docker Hub")
    • URL: Registry URL without https://
    • Username: Your registry username
    • Token: Paste your access token
  4. Click Test Connection
  5. Click Save

Common Registry URLs​

Public Registries:

  • Docker Hub: docker.io or registry-1.docker.io
  • GitHub: ghcr.io
  • GitLab: registry.gitlab.com
  • Quay.io: quay.io

Cloud Providers:

  • AWS ECR: [account-id].dkr.ecr.[region].amazonaws.com
  • Google GCR: gcr.io or [region]-docker.pkg.dev
  • Azure ACR: [registry-name].azurecr.io

Self-hosted:

  • Your registry domain (e.g., registry.company.com)
tip

Using a different registry? Just enter its URL. We support any standard container registry. Need help? Contact support.

Use in applications​

When creating an app:

  1. Select "Private Registry"
  2. Choose your registry
  3. Enter image name: username/image:tag

Update credentials​

  1. Go to Container Registries
  2. Click Edit on your registry
  3. Update the token
  4. Test and save

Troubleshooting​

"Authentication failed"

  • Check token is valid
  • Verify username is correct
  • Make sure token has read permissions

"Image not found"

  • Check image name spelling
  • Verify tag exists
  • Confirm repository is accessible

"Cannot connect"

  • Verify registry URL format
  • Check registry is online
  • Ensure no http:// prefix

Next Steps​