Skip to main content

atmos toolchain set

Set or update the version of a specific tool in your toolchain configuration. This allows you to pin tool versions for consistent execution across your components and workflows, or upgrade to newer versions when ready.

atmos toolchain set --help

Usage

Execute the toolchain set command like this:

atmos toolchain set <tool> <version>

Examples

atmos toolchain set terraform 1.11.4
atmos toolchain set hashicorp/terraform 1.11.4
atmos toolchain set terraform # Interactive version selection
atmos toolchain set --file /path/to/.tool-versions kubectl 1.28.0

Arguments

tool (required)

Tool to set the version for. Can be a short name (alias) or full owner/repo format.

Examples: terraform, kubectl, hashicorp/terraform

version (optional)

The version to set as default. If omitted, interactive version selection is used.

Examples: 1.9.8, 1.28.0

Flags

--file (optional)

Path to tool-versions file (defaults to global --tool-versions-file)