Skip to content

Docker Registry

Ops Atlas includes a built-in browser for your private Docker registry. Browse repositories, inspect tags, and view image details without leaving the dashboard.

Route

/registry

What You Can Do

  • Browse repositories — see all images in your registry
  • View tags — list all tags for a given repository with creation dates and sizes
  • Inspect image details — view layer information and metadata

Configuration

The registry connection is configured via environment variables:

bash
DOCKER_REGISTRY_URL=https://registry.example.com
DOCKER_REGISTRY_USERNAME=admin
DOCKER_REGISTRY_PASSWORD=secret

These can be set in your .env file or passed directly to the Docker container.

INFO

Registry configuration is optional. If not set, the Registry page will show a prompt to configure it. You can also configure it during the Setup Wizard.

Supported Registries

Ops Atlas works with any registry that implements the Docker Registry HTTP API V2:

  • Docker Registry (self-hosted)
  • Harbor
  • GitLab Container Registry
  • AWS ECR (with credentials)
  • Azure Container Registry
  • Google Artifact Registry

Authentication

The registry browser supports Basic authentication (username/password). Credentials are stored encrypted in the database and are never exposed to the frontend.

WARNING

If your registry uses a self-signed certificate, set DOCKER_REGISTRY_INSECURE=true to skip TLS verification. This is not recommended for production.

Released under the MIT License.