managing-astro-local-env

Original：🇺🇸 English

Not Translated

Manage local Airflow environment with Astro CLI. Use when the user wants to start, stop, or restart Airflow, view logs, troubleshoot containers, or fix environment issues. For project setup, see setting-up-astro-project.

1installs

Sourcenecatiarslan/airflow-vscode-extension

Added on2026-02-07

NPX Install

npx skill4agent add necatiarslan/airflow-vscode-extension managing-astro-local-env

SKILL.md Content

Astro Local Environment

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

Note: These are external CLI actions. For runtime inspection inside the VS Code extension, use the extension tools instead.

Start / Stop / Restart

bash

# 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

bash

astro dev ps

View Logs

bash

# 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

# 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

bash

astro dev kill
astro dev start

Upgrade Airflow

Test compatibility first

bash

astro dev upgrade-test

Change version

Edit Dockerfile:

dockerfile

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

Restart:
bash
```
astro dev kill && astro dev start
```

Related Skills

setting-up-astro-project
authoring-dags
testing-dags