# 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

**File:** `atmos.yaml`

```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

```yaml
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"
```