This guide provides instructions for how to install the Astro CLI.
The Astro CLI is the easiest way to run Apache Airflow on your machine. From the Astro CLI, you can run a local Apache Airflow environment with a dedicated webserver, scheduler and Postgres database. Once you create an Astronomer Software project, you can customize it (for example, add Python or OS-level packages or add plugins) and test it on your local machine.
You can also use the CLI to:
- Authenticate to Astronomer Software.
- List the Astro Workspace and Deployments you can access.
- Deploy a project to Software.
Install the Astro CLI
To use the Astro CLI on Mac, you must have:
To install the latest version of the Astro CLI, run the following command:
brew install astro
To use the Astro CLI on Windows, you must have:
- Docker Desktop for Windows.
- Docker Engine (v0.13.1 or higher).
- WSL enabled on your local machine.
- Windows 10 or Windows 11.
Go to the Releases page of the Astro CLI GitHub repository. Based on your desired CLI version and the CPU architecture of your machine, download one of the
.zipfiles available on this page.
For example, to install v1.0.0 of the Astro CLI on a Windows machine with an AMD 64 architecture, download
.zipfile does not automatically unzip, run the following command to unzip the executable:
tar -xvzf .\astrocli.tar.gz
Add the filepath for the directory containing
astro.exeas a PATH environment variable. For example, if
astro.exewas stored in
C:\Users\username\astro.exe, you would add
C:\Users\usernameas your PATH environment variable. To learn more about configuring the PATH environment variable, see Java documentation.
Restart your machine.
Confirm the install
To confirm the CLI was installed properly, run the following CLI command:
If the installation was successful, you should see the following output:
% astro version
Astro CLI Version: 1.2.0