Toolchain
Atmos Toolchain automatically installs tool dependencies like OpenTofu and Terraform declared in your Atmos configuration (`atmos.yaml`), ensuring consistent versions across local development and CI.
Atmos Toolchain automatically manages tool dependencies for your infrastructure project. You declare the tools and versions your project needs in your Atmos configuration, and Atmos automatically downloads and installs them when needed. This ensures everyone on the team and your CI pipelines use the exact same versions.
With Atmos Toolchain, you get:
Declarative tool version management in your atmos.yaml
Automatic installation — no manual steps required
Consistent versions across local development and CI
No need for separate tool installation steps in CI
Define the tools your project requires in your
atmos.yaml configuration under dependencies.tools:dependencies:
tools:
opentofu: 1.11.0That's it. When you run any Atmos command (e.g.,
atmos terraform plan), Atmos will automatically detect, download, and install the required tool versions before executing. There is no separate install step.Because installation is automatic, your GitHub Actions workflows don't need any extra steps for tool management. Just run your workflow inside the Atmos Docker container, and the toolchain takes care of the rest:
jobs:
atmos-plan:
runs-on:
- "ubuntu-latest"
container:
image: ghcr.io/cloudposse/atmos:${{ vars.ATMOS_VERSION }}
defaults:
run:
shell: bash
steps:
- name: Checkout
uses: actions/checkout@v6
- name: Plan Atmos Component
env:
COMPONENT: ${{ inputs.component }}
STACK: ${{ inputs.stack }}
run: atmos terraform plan "${COMPONENT}" -s "${STACK}"When
atmos terraform plan runs, Atmos automatically installs the declared version of OpenTofu (or Terraform) before executing the plan. This replaces individual tool installation steps and eliminates drift between local development and CI environments.For complete documentation, see the Atmos Toolchain documentation.
Next: Configure GitHub Workflows
Now that your toolchain is configured, set up your GitHub Actions workflows to work with Atmos Pro.