Skip to main content
Version: 0.28

Upgrade to a Stable or Patch Version of Astronomer Software


For Astronomer Software customers, new product features are regularly made available in stable and long-term support (LTS) releases as described in Release and Lifecycle Policy. Patch versions of Astronomer Software with additional bug and security fixes are also released on a regular basis.

All stable and patch releases of Astronomer Software require a simple upgrade process. When an LTS version is released, additional upgrade guidance specific to that version will be made available.

Follow this guide to upgrade to any stable or patch version of Astronomer Software. For information on new features and changes, refer to Software Release Notes.

A few notes before you get started:

  • The upgrade process will not affect running Airflow tasks as long as upgradeDeployments.enabled=false is set in the script below.
  • Patch and stable version updates will not cause any downtime to Astronomer services, including the Software UI, the Astronomer CLI, and the Houston API.

Astronomer v0.16.5 and beyond includes an improved upgrade process that allows Airflow Deployments to remain unaffected through a platform upgrade that includes changes to the Astronomer Airflow Chart.

Now, Airflow Chart changes only take effect when another restart event is triggered by a user. This includes a code push, a change to Environment Variables, or an adjustment to Deployment resources.


If you are upgrading from Astronomer Software v0.25, you first need to upgrade to the latest patch version of v0.26.x before upgrading to any subsequent stable release. To complete this upgrade:

  1. Complete the upgrade steps as described in this document. When you get to Step 3, set ASTRO_VERSION in Step 3 of this guide to the latest patch version of Software v0.26.
  2. Complete the same upgrade process. This time, when you get to Step 3, set ASTRO_VERSION to your desired v0.27+ version.

Step 1: Ensure You Have a Copy of Your Astronomer config.yaml File

First, ensure you have a copy of the config.yaml file of your platform namespace.

To do this, you can run:

helm get values <your-platform-release-name> -n <your-platform-namespace>  > config.yaml

Review this configuration and delete the line "USER-SUPPLIED VALUES:" if you see it.

Step 2: Verify Your Current Platform Version

To verify the version of Astronomer you're currently operating with, run:

helm list --all-namespaces | grep astronomer

Step 3: Run Astronomer's Upgrade Script

Now, review and run the script below to upgrade to the version of your choice.

set -xe


helm3 repo add astronomer
helm3 repo update

# upgradeDeployments false ensures that Airflow charts are not upgraded when this script is ran
# If you deployed a config change that is intended to reconfigure something inside Airflow,
# then you may set this value to "true" instead. When it is "true", then each Airflow chart will
# restart. Note that some stable version upgrades require setting this value to true regardless of your own configuration.
helm3 upgrade --namespace $NAMESPACE \
-f ./config.yaml \
--reset-values \
--version $ASTRO_VERSION \
--set astronomer.houston.upgradeDeployments.enabled=false \

Make sure to substitute the following 3 variables with your own values:

  • <astronomer-platform-release-name>
  • <astronomer-platform-namespace>
  • <astronomer-patch-version>

To upgrade to Astronomer Software v0.27.0, for example, set ASTRO_VERSION=0.27.0.


If you do not specify a patch version above, the script will automatically pull the latest Astronomer Software patch available in the Astronomer Helm Chart. If you set ASTRO_VERSION=0.26 for example, Astronomer v0.26.5 will be installed if it is the latest v0.26 patch available.