> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# astro deployment runtime upgrade

<Info>This command is available only if you're authenticated to an Astro Private Cloud installation.</Info>

Initializes the Runtime version upgrade process on any Deployment on Astro Private Cloud.

## Usage

Run `astro deployment runtime upgrade --deployment-id=<deployment-id>` to initialize the Runtime upgrade process. To finalize the Runtime upgrade process, complete all of the steps in [Upgrade Apache Airflow on Astro Private Cloud](https://www.astronomer.io/docs/software/manage-airflow-versions).

## Options

| Option                         | Description                                                                                                                 | Possible values               |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| `--cancel`                     | Cancel the upgrade                                                                                                          | None                          |
| `--deployment-id` (*Required*) | The ID of the Deployment for which you want to upgrade Runtime. Run `astro deployment list ` to retrieve the Deployment ID. | Any Deployment ID             |
| `--desired-runtime-version`    | The Runtime version you're upgrading to. For example, `2.2.0`.                                                              | Any supported Runtime version |

## Examples

```text wrap theme={null}
# Upgrade to Runtime 6.0.0
$ astro deployment runtime --deployment-id telescopic-sky-4599 --desired-runtime-version 6.0.0
```

## Related commands

* [`astro deployment airflow upgrade`](/docs/cli/v1.43/astro-deployment-airflow-upgrade)
* [`astro deployment runtime migrate`](/docs/cli/v1.43/astro-deployment-runtime-migrate)