How do I fix a 'Port 8080 in use' error?

You should stop any other local processes using that port or edit your .astro/config.yaml file to map Airflow to a different local port.

How do I restart only the Airflow scheduler?

You can use the specific component restart command: 'astro dev restart --scheduler' to reboot the scheduler without affecting other containers.

Can I run standard Airflow CLI commands through this skill?

Yes, use the 'astro dev run airflow [command]' syntax to execute any standard Airflow CLI command inside your running containers.

When should I use 'astro dev kill' instead of 'astro dev stop'?

Use 'astro dev stop' to preserve data and volumes; use 'astro dev kill' when you need a clean slate or if containers are unresponsive and need to be forced down.

What are the default login credentials for the local webserver?

The local Astro environment uses 'admin' as both the default username and password for the Airflow UI at http://localhost:8080.

Astro Local Environment Manager

Name: Astro Local Environment Manager
Author: astronomer

byastronomer

•

Deployment & DevOps

Manages local Apache Airflow environments via the Astro CLI to streamline data engineering development and container orchestration.

About

This skill provides a comprehensive interface for managing local Airflow instances using the Astro CLI within Claude. It enables users to efficiently start, stop, and restart environments, monitor real-time logs for specific components like the scheduler or webserver, and troubleshoot container-level issues. Whether you need to access a container shell, run Airflow CLI commands, or perform environment resets and runtime upgrades, this skill offers the necessary domain-specific guidance and implementation patterns to maintain a healthy local development setup for data pipelines.

Key Features

Real-time log streaming and component-specific debugging for the Airflow webserver and scheduler.
Full lifecycle management including start, stop, restart, and clean-slate kill commands.
Direct container shell access and Airflow CLI command execution via astro dev run.
77 GitHub stars
Guided Airflow runtime upgrade testing and Dockerfile version management.
Integrated troubleshooting guide for port conflicts, package failures, and disk space issues.

Use Cases

Initializing and resetting local Airflow environments during the data pipeline development lifecycle.
Debugging DAG import errors and execution failures by inspecting container logs and internal status.
Testing Airflow version upgrades and dependency changes in requirements.txt before production deployment.

About

Key Features

Real-time log streaming and component-specific debugging for the Airflow webserver and scheduler.
Full lifecycle management including start, stop, restart, and clean-slate kill commands.
Direct container shell access and Airflow CLI command execution via astro dev run.
77 GitHub stars
Guided Airflow runtime upgrade testing and Dockerfile version management.
Integrated troubleshooting guide for port conflicts, package failures, and disk space issues.

Use Cases

Initializing and resetting local Airflow environments during the data pipeline development lifecycle.
Debugging DAG import errors and execution failures by inspecting container logs and internal status.
Testing Airflow version upgrades and dependency changes in requirements.txt before production deployment.