managing-astro-local-env

SKILL.md

Manage local Airflow development environment with Astro CLI commands.

Start, stop, restart, and kill local Airflow containers; default credentials are admin/admin with webserver at http://localhost:8080

View logs for all components or specific services (scheduler, webserver) with real-time follow option

Access container shells and run Airflow CLI commands directly via astro dev bash and astro dev run

Troubleshoot common issues including port conflicts, startup failures, package errors, and DAG parsing problems with quick reset procedures

Upgrade Airflow versions by editing the Dockerfile and testing compatibility before applying changes

Astro Local Environment

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

Two modes: Docker (default, uses containers) and Standalone (Docker-free, uses a local venv — requires Airflow 3 + uv).

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 (Docker)

# Start local Airflow (webserver at http://localhost:8080)
astro dev start

# Stop containers (preserves data)
astro dev stop