Skip to main content

astro deployment runtime migrate


This command is available only if you're authenticated to an Astronomer Software installation.

Initializes the Runtime migration upgrade process on any Deployment on Astronomer Software.


Run astro deployment runtime migrate --deployment-id=<deployment-id> to initialize the Runtime upgrade process. To finalize the Runtime upgrade process, complete all of the steps in Migrate to Astro Runtime.

The Astro CLI lists only the available Runtime versions that are later than the version currently specified in your Dockerfile.


OptionDescriptionPossible values
--cancelCancel the migrationNone
--deployment-id (Required)The ID of the Deployment which you want to migrate to Runtime. To find your Deployment ID, run astro deployment list.Any Deployment ID

Was this page helpful?

Sign up for Developer Updates

Get a summary of new Astro features once a month.

You can unsubscribe at any time.
By proceeding you agree to our Privacy Policy, our Website Terms and to receive emails from Astronomer.