Astro Local Environment

This skill helps you manage your local Airflow environment using the Astro CLI.

To set up a new project, see the setting-up-astro-project skill. When Airflow is running, use MCP tools from authoring-dags and testing-dags skills.

Start / Stop / Restart

Start local Airflow (webserver at http://localhost:8080)

astro dev start

Stop containers (preserves data)

astro dev stop

Kill and remove volumes (clean slate)

astro dev kill

Restart all containers

astro dev restart

Restart specific component

astro dev restart --scheduler astro dev restart --webserver

Default credentials: admin / admin

Restart after modifying: requirements.txt, packages.txt, Dockerfile

Check Status astro dev ps

View Logs

All logs

astro dev logs

Specific component

astro dev logs --scheduler astro dev logs --webserver

Follow in real-time

astro dev logs -f

Access Container Shell

Bash into scheduler container

astro dev bash

Run Airflow CLI commands

astro dev run airflow info astro dev run airflow dags list

Troubleshooting Issue Solution Port 8080 in use Stop other containers or edit .astro/config.yaml Container won't start astro dev kill then astro dev start Package install failed Check requirements.txt syntax DAG not appearing Run astro dev parse to check for import errors Out of disk space docker system prune Reset Environment

When things are broken:

astro dev kill astro dev start

Upgrade Airflow Test compatibility first astro dev upgrade-test

Change version

Edit Dockerfile:

FROM quay.io/astronomer/astro-runtime:13.0.0

Restart:

astro dev kill && astro dev start

Related Skills setting-up-astro-project: Initialize projects and configure dependencies authoring-dags: Write DAGs (uses MCP tools, requires running Airflow) testing-dags: Test DAGs (uses MCP tools, requires running Airflow)