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 installs Podman, by default, as its container management engine for running Airflow locally. If your organization uses Docker to run and manage containers, you can opt out of installing Podman with the Astro CLI, allowing the Astro CLI to use your existing runtime setup. To opt out, install from our tap with brew install astronomer/tap/astro --without-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.

Confirmation

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