Skip to main content

Version Providers

version.providers names the remote systems Atmos uses to discover and resolve versions. Entries in version.dependencies reference providers by name.

Providers are lookup backends, not the software catalog itself. Use them for registries and APIs such as Docker Hub, OCI registries, ECR, and GitHub.

Configuration​

atmos.yaml
version:
  providers:
    github:
      kind: github

    dockerhub:
      kind: docker
      url: registry-1.docker.io

    ghcr:
      kind: oci
      url: ghcr.io

    ecr_prod:
      kind: aws/ecr
      region: us-east-1
      registry_id: "123456789012"

    local_registry:
      kind: oci
      url: localhost:5000
      insecure: true

Fields​

kind
Provider kind, such as github, docker, oci, or aws/ecr.
url
Registry or API endpoint used by the provider.
region
Cloud region for regional providers such as ECR.
registry_id
Registry account or tenant identifier, such as an AWS account ID for ECR.
insecure
Allow plain-HTTP registry access. Use only for local or emulated registries.

Example​

version:
  providers:
    dockerhub:
      kind: docker
      url: registry-1.docker.io
  dependencies:
    nginx:
      ecosystem: oci
      datasource: oci-tags
      provider: dockerhub
      package: library/nginx
      desired: "1.29.0"