Skip to main content

Helm Configuration

Tell Atmos where native Helm component files live. These project-wide settings keep stack files focused on what to deploy, while atmos.yaml defines how Helm components are found. Charts are rendered and deployed through the Helm Go SDK, so no helm or helmfile binary is required.

Configuration​

atmos.yaml
components:
  helm:
    # Base path to native Helm component directories (where local charts live).
    base_path: components/helm

    # Generate files from the component `generate` section before operations.
    auto_generate_files: false

    # Reusable chart repositories available to native Helm components.
    repositories:
      - name: prometheus-community
        url: https://prometheus-community.github.io/helm-charts

Configuration Reference​

base_path
Base directory for native Helm components. Local charts referenced with a relative chart path resolve under each component directory. Defaults to components/helm.
auto_generate_files
When true, Atmos renders the component generate section into the component directory before Helm operations. Defaults to false.
repositories

Reusable Helm chart repositories. Components can reference these with chart: repo-name/chart-name. Component-level repositories entries override global entries with the same name.

Helm Repositories​

Global repositories are declared once in atmos.yaml:

atmos.yaml
components:
  helm:
    repositories:
      - name: prometheus-community
        url: https://prometheus-community.github.io/helm-charts
      - name: internal
        url: https://charts.example.com
        username: !env HELM_REPO_USERNAME
        password: !env HELM_REPO_PASSWORD
        pass_credentials_all: true

Supported repository fields:

name (required)
Repository name used in repo/chart references.
url (required)
HTTP chart repository URL.
username, password
Basic authentication credentials for the repository.
pass_credentials_all
Pass credentials to chart URLs on all domains, matching Helm's --pass-credentials behavior.
cert_file, key_file, ca_file
TLS client certificate, key, and CA bundle files.
insecure_skip_tls_verify
Skip TLS certificate verification for repository access.

Before template, diff, apply, or deploy, Atmos adds or updates these repositories in Helm's local repository config and downloads their indexes into Helm's repository cache. delete does not update repositories.

See the atmos helm command and the Helm stack configuration for component-level fields.