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