There are multiple ways to install, upgrade, and uninstall the Astro CLI. Install the Astro CLI to start running Airflow locally or to manage Astro from your terminal.
Starting with version 1.32.0, the Astro CLI Homebrew tap installs Podman by default on macOS to run Airflow locally. If your organization uses Docker and you want to skip installing Podman, install from the Astronomer tap and pass --without-podman (macOS only):
brew install astro (Homebrew core) does not support --without-podman and will install Podman.To install the latest version of the Astro CLI, run the following command:
To install a specific version of the Astro CLI, specify the version you want to install at the end of the command. For example, to install Astro CLI version 1.36.0, you would run the following command:
If you specify only a major version, this command installs the latest minor or patch version available for the major version. For a list of all available versions, see the CLI release notes.
To verify that the correct Astro CLI version was installed, run:
Follow this procedure when Homebrew fails to install the latest Astro CLI version or the error No formulae or casks found for astro@<major.minor.patch-version> appears. To troubleshoot other Homebrew issues, see Common Issues in the Homebrew documentation.
If the install process is not working, run the following command to update Homebrew and all package definitions (formulae):
Re-run the installation again:
If this is the first time you’re installing the CLI and updating Homebrew doesn’t work, check to see if astronomer/tap is in your Homebrew tap list:
If astronomer/tap is in your tap list and you still can’t install the Astro CLI, you might be experiencing a different issue. See Common Issues in the Homebrew documentation.
Run the following command to install the Astronomer CLI:
--without-podmanRun brew tap astronomer/tap, then retry the install.
You’re installing the Homebrew core formula. Use the fully qualified tap formula:
Uninstall it, then reinstall from the tap: