Skip to main content

atmos version

Purpose

Use this command to get the Atmos CLI version

atmos help

Usage​

Execute the atmos version command like this:

atmos version

This will show the CLI version.

From time to time, Atmos will check for updates. The frequency of these checks is configured in the atmos.yaml file.

Atmos supports three ways to specify the update check frequency:

  1. As an integer: Specify the number of seconds between checks (for example, 3600 for hourly checks).
  2. As a duration with a suffix: Use a time suffix to indicate the interval (for example, 1m for one minute, 5h for five hours, or 2d for two days).
  3. As one of the predefined keywords: Choose from the following options: minute, hourly, daily, weekly, monthly, and yearly. The default is daily. The default is to check daily, and if any unsupported values are passed this default will be used.

It is also possible to turn off version checks in atmos.yaml by setting version.check.enabled to false, or by setting the ATMOS_VERSION_CHECK_ENABLED environment variable to false, which overrides the version.check.enabled settings in atmos.yaml.

atmos version --check

The version command supports a --check flag. This will force Atmos to check for a new version, irrespective of the configuration settings.

tip

To find the latest version of Atmos, go to the releases page on GitHub. For help with installing the latest version of Atmos, check out our installation page.

When executing the atmos version command, Atmos automatically checks for the latest release from the Atmos releases page on GitHub and compares the current version with the latest release.

If the installed Atmos version is out of date, the following information is presented to the user: