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.

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

01Real-time log streaming and component-specific debugging for the Airflow webserver and scheduler.

02Full lifecycle management including start, stop, restart, and clean-slate kill commands.

03Direct container shell access and Airflow CLI command execution via astro dev run.

0477 GitHub stars

05Guided Airflow runtime upgrade testing and Dockerfile version management.

06Integrated troubleshooting guide for port conflicts, package failures, and disk space issues.

Use Cases

01Initializing and resetting local Airflow environments during the data pipeline development lifecycle.

02Debugging DAG import errors and execution failures by inspecting container logs and internal status.

03Testing Airflow version upgrades and dependency changes in requirements.txt before production deployment.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add astronomer/agents managing-astro-local-env

For use in Claude.ai and ChatGPT

Download Skill