> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Run Airflow locally

> Work with your Astro project in a local environment by running Airflow and dags locally.

Running Airflow locally with the Astro CLI lets you preview and debug dag changes before deploying to production. In a local Airflow environment, you can fix issues with your dags without consuming infrastructure resources or waiting on code deploy processes.

The Astro CLI supports multiple modes for running Airflow locally:

* **Container mode (default):** Uses Podman or Docker to run Airflow components in containers. All tasks run locally in the scheduler container using the [local executor](https://airflow.apache.org/docs/apache-airflow/stable/core-concepts/executor/local.html).
* **Standalone mode:** Runs Airflow directly on your machine in a virtual environment, without Docker or Podman. This can enable faster iteration in development as you don't have to wait for containers to rebuild. Use `astro dev start --standalone` or set it as your default with `astro config set dev.mode standalone`. See [astro dev start](https://astronomer.io/docs/cli/v1.47/astro-dev-start.md) for all available options.

See the following documentation to get started:

* [Run Airflow locally](https://astronomer.io/docs/cli/v1.47/run-airflow-locally.md)
* [Test your dags](https://astronomer.io/docs/cli/v1.47/test-your-astro-project-locally.md)
* [Troubleshoot locally](https://astronomer.io/docs/cli/v1.47/troubleshoot-locally.md)
* [Sync Deployment connections from Astro](https://astronomer.io/docs/cli/v1.47/local-connections.md)