Install Atmos

There are many ways to install Atmos. Choose the method that works best for you!

To check what version of Atmos you have installed, just run atmos version. The latest version of Atmos is v1.88.1.

To find the latest available version of Atmos, visit the Releases Page. The latest version will always be available for download here.

Using OS Package Managers

Atmos has native packages for macOS and every major Linux distribution. We also supply binary releases for Windows.

macOS

macOS (OSX)

From Homebrew, install directly by running:

brew install atmos

Pro tip! Use a Brewfile

Create a Brewfile in your Atmos project, and add brew "atmos". This way, you can ensure that everyone on your team is using the same version of Atmos.

Brewfile

brew "atmos", "v1.88.1"

Then just run brew install in the same directory as the Brewfile.

Debian/Ubuntu

Debian Linux (DEB)

On Debian, use the Cloud Posse package repository provided by Cloudsmith:

# Add the Cloud Posse package repository hosted by Cloudsmith
apt-get update && apt-get install -y apt-utils curl
curl -1sLf 'https://dl.cloudsmith.io/public/cloudposse/packages/cfg/setup/bash.deb.sh' │ bash

# Install atmos
apt-get install atmos@="${ATMOS_VERSION}-*"

RedHat/CentOS

RedHat/CentOS Linux (RPM)

On RedHat or CentOS, use the Cloud Posse package repository provided by Cloudsmith:

curl -1sLf 'https://dl.cloudsmith.io/public/cloudposse/packages/setup.rpm.sh' │ sudo -E bash

# Install atmos
sudo yum install atmos-${ATMOS_VERSION}.x86_64

Alpine Linux

Alpine Linux (APK)

On Alpine, use the Cloud Posse package repository provided by Cloudsmith:

# Install the Cloud Posse package repository hosted by Cloudsmith
curl -fsSL 'https://dl.cloudsmith.io/public/cloudposse/packages/setup.alpine.sh' │ bash

# Install atmos
apk add atmos@cloudposse

NixOS

NixOS

On NixOS, run the following command to install:

nix-env -iA nixpkgs.atmos

Windows

Windows via scoop.sh

On Windows, run the following command to install:

scoop install atmos

NOTE: Don't have scoop? Install it first from https://scoop.sh/

Go

Install with Go

Install the latest version:

go install github.com/cloudposse/atmos

Grab a specific version:

go install github.com/cloudposse/atmos@v1.64.0

Or specifically request the latest version.

go install github.com/cloudposse/atmos@latest

NOTE: Since the version is passed in via -ldflags during the build, when running go install without using -ldflags, the CLI will return 0.0.1 when running atmos version.

asdf

Install with asdf

Install plugin dependencies as listed in asdf-atmos repository:

apt-get update && apt-get install -y bash curl tar

Install the plugin:

asdf plugin add atmos https://github.com/cloudposse/asdf-atmos.git

Install a specified version:

asdf install atmos <LatestRelease />

Alternatively, create a .tool-versions file in your project to specify a consistent version for the users:

.tool-versions

atmos v1.88.1

Then, run asdf install in the same directory.

NOTE: Don't have asdf? Install it first from here

Mise

Install with Mise

Install a specified version:

mise use atmos@<LatestRelease />

Alternatively, create a .mise.toml file in your repository to specify a consistent version for the users:

.mise.toml

[tools]
atmos = 'v1.88.1'

Then, run mise install in the same directory.

NOTE: Don't have mise? Install it first from here

From Source

Build from Source

make build

or run this and replace $version with the version that should be returned with atmos version.

go build -o build/atmos -v -ldflags "-X 'github.com/cloudposse/atmos/cmd.Version=$version'"

Automatic Installer

Automatic Installer

If you're not sure which method to use, you can always use the automatic installer. It will figure out which of the mechanisms above to use, and perform it.

Paste the following into a macOS Terminal or Linux shell prompt.

curl -fsSL https://atmos.tools/install.sh | bash

note

The latest version of Atmos (v1.88.1) might not be available with third-party package managers.

Download Binaries from Releases Page

• Go to Releases Page

• Download the binary for your operating system and architecture. Replace ${version} with the desired version

  • e.g. If you’re on a Mac (M1/M2/M3), download the atmos_${version}_darwin_arm64 binary
  • e.g. If you’re on an Intel Mac, download the atmos_${version}_darwin_amd64 binary
  • e.g. If you’re on Windows, download atmos_${version}_windows_amd64.exe, etc.

• Rename the downloaded file to atmos (optional)

• Add the execution bit to the binary (e.g. on Linux and Mac, run chmod u+x atmos)

• Place the binary somewhere on your PATH (e.g. on Linux and Mac: mv atmos /usr/local/bin/)

Next Steps

Now, try one of our Quick Start guides to get started with Atmos

Simple Tutorial

Advanced Tutorial