Skip to main content

atmos version install

Install a specific version of Atmos for use with version pinning or manual version switching.

Usage​

Execute the version install command like this:

atmos version install <version>

This command downloads and installs the specified version of Atmos to ~/.atmos/bin/cloudposse/atmos/<version>/.

tip

Use atmos version list to see available versions on GitHub before installing.

Arguments​

version (required)
The version to install. Can be a specific version (e.g., 1.194.0) or latest.

Examples​

Install a specific version:

atmos version install v1.203.0

Install the latest version:

atmos version install latest

How It Works​

The version install command is a convenience wrapper around the Atmos toolchain installer:

# These are equivalent:
atmos version install 1.160.0
atmos toolchain install atmos@1.160.0

Installed versions are stored in:

~/.atmos/bin/cloudposse/atmos/<version>/atmos

Use Cases​

Pin Version Per Project​

Install the version specified in your project's atmos.yaml:

version:
  use: 1.160.0

Then install it:

atmos version install 1.160.0

Prepare for Upgrade​

Install a new version before switching to it:

# Install new version
atmos version install latest

# Test it manually
~/.atmos/bin/cloudposse/atmos/1.195.0/atmos version

# Update your atmos.yaml to use it

Team Standardization​

Ensure everyone on your team has the required version:

# Check what's installed
atmos version installed

# Install any missing versions
atmos version install 1.160.0