---
id: astronomer-starship
version: "2.9.1"
license: PROPRIETARY
license_treatment: unclear
maintenance: active
---

# astronomer-starship — Migrations to Astro

License: unclear · Maintenance: active · Downloads: 96.3K/mo

## 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 above — 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

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

- License: PROPRIETARY (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 96.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

airflow metadata migration, migrate airflow variables connections, airflow instance migration, airflow data transfer, airflow backup restore, airflow environment migration, airflow pool migration, airflow, migration, data-transfer

[View on SkillFed](https://skillfed.io/packages/astronomer-starship) · [View on PyPI](https://pypi.org/project/astronomer-starship/)