Upgrade the Astro CLI

Instructions for upgrading the Astro command-line interface (CLI).

The Astro CLI contains no breaking changes between minor versions within the same major version. Therefore, Astronomer recommends always using the latest minor version of the Astro CLI within your major version.

Upgrade the existing CLI

Mac

Run the following command to upgrade the Astro CLI to the latest version:

brew upgrade astro

Windows with winget

To upgrade the Astro CLI to the latest version, open Windows PowerShell as an administrator and run the following command:

winget install -e --id Astronomer.Astro

Note that if you’re upgrading from Astro CLI version 1.5.1 or earlier to a later Astro CLI version, you still need to install the upgrade version manually.

Windows (Manual)

1. Delete the existing astro.exe file on your machine.

2. Go to the Releases page of the Astro CLI GitHub repository, scroll to a CLI version, and then download the .exe file that matches the CPU architecture of your machine.

For example, to upgrade to v1.0.0 of the Astro CLI on a Windows machine with an AMD 64 architecture, you download astro_1.0.0-converged_windows_amd64.exe.

3. Rename the file to astro.exe.

4. Add the filepath for the directory containing the new astro.exe as a PATH environment variable. For example, if astro.exe was stored in C:\Users\username\astro.exe, you would add C:\Users\username as your PATH environment variable. To learn more about configuring the PATH environment variable, see Java documentation.

5. Restart your machine.

Linux

To upgrade the Astro CLI to the latest version, run the following command:

curl -sSL install.astronomer.io | sudo bash -s