Install the CLI

Install the Astro CLI

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.

If you can’t install the Astro CLI on your local machine, you can still run Astro CLI commands and deploy to Astro using GitHub Actions.

Prerequisites

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):

1brew tap astronomer/tap
2brew install astronomer/tap/astro --without-podman
brew install astro (Homebrew core) does not support --without-podman and will install Podman.

Installation

To install the latest version of the Astro CLI, run the following command:

1brew install astro

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:

1brew install astro@1.36.0

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:

1astro version

Resolve installation issues

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.

  1. If the install process is not working, run the following command to update Homebrew and all package definitions (formulae):

    1brew update

  2. Re-run the installation again:

    1brew install astro

  3. 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:

    1brew tap astronomer/tap

    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.

  4. Run the following command to install the Astronomer CLI:

    1brew install astro

Troubleshooting --without-podman

Error: No available formula or cask with the name “astronomer/tap/astro”

Run brew tap astronomer/tap, then retry the install.

Error: invalid option: —without-podman

You’re installing the Homebrew core formula. Use the fully qualified tap formula:

1brew install astronomer/tap/astro --without-podman

Already installed core formula

Uninstall it, then reinstall from the tap:

1brew uninstall astro
2brew install astronomer/tap/astro --without-podman