astronomer-starship

What it is and what it does

Astronomer Starship is a migration utility designed to transfer Airflow metadata between two Airflow instances. It handles Variables, Connections, Environment Variables, Pools, and DAG History—the operational state and configuration that define how Airflow DAGs run. The package is built for scenarios where you need to move or replicate an Airflow environment, such as upgrading to a new instance, migrating to Astronomer's managed platform, or setting up a disaster-recovery copy.

The tool is actively maintained and supports Python 3.6 through 3.12. It has no external runtime dependencies, making installation straightforward. However, its PROPRIETARY license status is unclear, so you should verify licensing terms with Astronomer before using it in production or in environments where licensing compliance is a concern.

Use it for:

• Migrate Airflow configuration and history when upgrading to a newer Airflow version on a new instance.
• Transfer DAG metadata and connection secrets to Astronomer's managed Airflow platform.
• Replicate an Airflow environment for disaster recovery or testing purposes.
• Move Airflow metadata between on-premises and cloud-hosted instances.
• Consolidate metadata from multiple Airflow instances into a single environment.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Migrates Airflow metadata—Variables, Connections, Environment Variables, Pools, and DAG History—between two Airflow instances.

Yes, if you need to migrate Airflow metadata and have confirmed the PROPRIETARY license is acceptable for your use case. The package is actively maintained, has low install friction, no external dependencies, and supports a wide range of Python versions. Verify licensing terms with Astronomer first, and confirm the tool supports your specific migration scenario (version compatibility, metadata scope) before relying on it in production.

Install

astronomer-starship on PyPI

pip install astronomer-starship

uv add astronomer-starship

poetry add astronomer-starship

Installing astronomer-starship

Before you install

Low install friction with no runtime dependencies. Active maintenance as of 2026-08-12 with recent releases, though the repository has modest visibility at 35 stars.

License in practice

Licensed as PROPRIETARY with unclear treatment. Verify licensing terms with Astronomer before deploying in production or redistributing.

Quickstart

pip install astronomer-starship

from astronomer.starship import Starship

starship = Starship(source_airflow_home='/path/to/source', target_airflow_home='/path/to/target')
starship.migrate()

Requires direct filesystem access to both source and target Airflow instances' metadata directories or database connections.

Verify before relying

• Whether PROPRIETARY license permits use in commercial or closed-source environments without explicit agreement.
• Whether the package supports migration between different Airflow versions or only same-version instances.
• Data validation and rollback capabilities during migration.
• Whether DAG history migration includes full execution logs or metadata only.

Package facts

Evidence: astronomer_starship-2.9.1-py3-none-any.whl

Tags

More Distributed Computing packages