🇺🇸English

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

Reset Environment

When things are broken:

astro dev kill
astro dev start

Upgrade Airflow

Test compatibility first

astro dev upgrade-test

Change version

1. Edit Dockerfile:

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

2. 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)
• deploying-airflow : Deploy DAGs to production (Astro, Docker Compose, Kubernetes)

Weekly Installs

373

Repository

astronomer/agents

GitHub Stars

269

First Seen

Jan 23, 2026

Security Audits

Gen Agent Trust HubPassSocketPassSnykWarn

Installed on

opencode272

codex267

github-copilot266

cursor266

gemini-cli252

claude-code235