For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
      • AstroFully-managed data operations, powered by Apache Airflow.
      • Astro Private CloudRun Airflow-as-a-service in your environment.
      • Professional ServicesExpert Airflow services for your enterprise's success.
    • Tools
      • Cosmos
      • Orbiter
      • CLI
      • AI SDK
      • Agents
      • Blueprint
      • UpdatesThe State of Airflow 2026See the insights from over 5,800 data practitioners in the full report. Download Now ➔
  • Customers
  • Docs
    • Insights
      • Blog
      • Webinars
      • Resource Library
      • Events
    • Education
      • Academy
      • What is Airflow?
  • Pricing
Get Started Free
    • Overview
      • User roles and permissions
      • System components
      • Helm chart configuration reference
      • Support
      • Version compatibility reference
      • Release and lifecycle policy
      • FAQ
      • Astro CLI command reference
    • Book Office Hours

Product

  • Platform Overview
  • Astro
  • Astro Observe
  • Astro Private Cloud
  • Security & Trust
  • Pricing

Tools & Services

  • Cosmos
  • Docs
  • Professional Services
  • Product Updates

Use Cases

  • AI Ops
  • Data Observability
  • ETL/ELT
  • ML Ops
  • Operational Analytics
  • All Use Cases

Industries

  • Financial Services
  • Gaming
  • Retail
  • Manufacturing
  • Healthcare
  • All Industries

Resources

  • Academy
  • eBooks & Guides
  • Blog
  • Webinars
  • Events
  • The Data Flowcast Podcast
  • All Resources

Airflow

  • What is Airflow
  • Airflow on Astro
  • Airflow 3.0
  • Airflow Upgrades
  • Airflow Use Cases
  • Airflow 2.x End of Life

Company

  • Our Story
  • Customers
  • Newsroom
  • Careers
  • Contact

Support

  • Knowledge Base
  • Status
  • Contact Support
GitHubYouTubeLinkedInx
  • Legal
  • Privacy
  • Terms of Service
  • Consent Preferences

  • Do Not Sell or Share My Personal information
  • Limit the Use Of My Sensitive Personal Information

Apache Airflow®, Airflow, and the Airflow logo are trademarks of the Apache Software Foundation. Copyright © Astronomer 2026. All rights reserved.

LogoLogo
On this page
  • Astronomer Software
  • Kubernetes version support table and policy
  • General recommendations for Kubernetes upgrades
  • Airflow chart compatibility reference
  • Legacy version compatibility reference
Reference

Version compatibility reference for Astronomer Software

Edit this page
Built with

Astronomer Software ships with and requires a number of adjacent technologies that support it, including Kubernetes, Helm, and Apache Airflow itself. This guide provides a reference of all required tools and versions for running Astronomer Software.

While the tables below reference the minimum compatible versions, we typically recommend running the latest versions of all tooling if and when possible.

Find detailed information about the component image versions, including which versions were used to test a particular Astronomer Software version in the Astronomer Software release index.

Astronomer Software

The following table shows version compatibility information for all currently supported versions of Astronomer Software and some legacy versions. Check Astronomer Software lifecycle schedule for more information about supported versions of Astronomer Software.

Astronomer PlatformPostgresAstro Runtime
v0.3413+All Airflow 2.x Runtime versions
v0.3613+All Airflow 2.x Runtime versions
v0.3713+All Airflow 2.x Runtime versions

See Kubernetes version support table and policy for Astronomer platform compatibility with Kubernetes.

Astronomer does not support Postgres versions that are beyond their end-of-life date. You can check to see the currently supported versions of Postgres.

Astronomer recommends using the latest available version of the Astro CLI for all Software versions, in most cases. To upgrade from an earlier version of the CLI to the latest, see Upgrade to Astro CLI version 1.0+.

For more detail about the changes in each Astronomer Software release, see the Astronomer Software Release Notes.

Only Astronomer-distributed images supporting Airflow 2.x are compatible with all versions of Astronomer Software. Astro Runtime maintenance is independent of Software maintenance. For more information, see Astro Runtime maintenance and lifecycle policy.

Kubernetes version support table and policy

In general, Astronomer Software will support a given version of Kubernetes through its End of Life. This includes Kubernetes upstream and cloud-managed variants like GKE, AKS, and EKS. When a version of Kubernetes reaches End of Life, support will be removed in the next major or minor release of Astronomer Software. For more information on Kubernetes versioning and release policies, refer to Kubernetes Release History or your cloud provider.

See the following table for all supported Kubernetes versions in each maintained version of Astronomer Software.

Astro Private CloudKubernetes 1.271.281.291.301.311.321.331.34
0.37.0✔️✔️✔️✔️✔️
0.37.1-0.37.3✔️✔️✔️✔️
0.37.4✔️✔️✔️✔️✔️
0.37.5-0.37.6✔️✔️✔️✔️
0.37.7✔️✔️✔️✔️

General recommendations for Kubernetes upgrades

If there are no workloads running on the nodes you want to upgrade, there won’t be an immediate impact on the Astronomer or Airflow components during the initial phase of upgrading your managed node groups. To minimize disruptions, however, perform a controlled rollout restart of the worker nodes. During your controlled rollout, monitor the health of the new nodes and workloads before decommissioning the old nodes.

Before beginning the upgrade process, ensure you have all necessary backups ready. After upgrading, verify that all Astronomer and Airflow components are running as expected on the new nodes. After the Astronomer version is compatible with the EKS/AKS Cluster, you don’t need to change you Astronomer configurations or settings. However, the upgrade requires restarting the Kubelet on each node, which causes the Astro and Airflow components to also restart.

For more information on upgrading Kubernetes versions, follow the guidelines offered by your cloud provider.

  • Amazon EKS
  • Azure AKS
  • Google GKE
  • RedHat OpenShift

Airflow chart compatibility reference

Astronomer Software Deployments utilize the Astronomer-distributed Helm chart for Apache Airflow. A Deployment’s Airflow chart defines how a Deployment autoscales Pods and interacts with other components in your cluster.

Use the following table to see the Airflow Helm chart version for each supported version of Astronomer Software. To view the Airflow Helm chart for an unsupported version of Astronomer Software, open the default Astronomer Helm chart in the astronomer/astronomer repository and select the Tag that corresponds to the unsupported version. The value of airflowChartVersion is the Airflow Helm chart version.

Astronomer platform versionAstronomer Airflow Helm chart version
0.34.01.10.0
0.34.11.10.0
0.34.21.10.2
0.34.31.10.2
0.34.41.10.4
0.36.01.13.5
0.36.11.13.10
0.37.01.14.0
0.37.11.14.3
0.37.21.14.5
0.37.31.15.2
0.37.41.15.5
0.37.51.15.7
0.37.61.15.8

Legacy version compatibility reference

The following table shows version compatibility information for all versions of Astronomer Software which are no longer supported:

Astronomer PlatformKubernetesPostgresAstro Runtime
v0.261.17, 1.18, 1.19, 1.20, 1.219.6+All Astronomer Certified versions
v0.271.18, 1.19, 1.20, 1.219.6+All Astronomer Certified versions
v0.281.19¹, 1.20¹, 1.21, 1.22, 1.23, 1.249.6+All Astronomer Certified versions
v0.291.19¹, 1.20¹, 1.21, 1.22, 1.23, 1.249.6+All supported Certified and Runtime versions
v0.301.22¹, 1.23, 1.24, 1.25, 1.26, 1.27¹11+All Runtime versions supporting Airflow 2.x
v0.311.21, 1.22, 1.23, 1.24, 1.25¹, 1.26¹11.19+All Runtime versions supporting Airflow 2.x
v0.321.22¹, 1.23, 1.24¹, 1.25, 1.26, 1.27, 1.29¹11+All Runtime versions supporting Airflow 2.x
v0.331.24, 1.25, 1.26, 1.27, 1.28, 1.2911+All Runtime versions supporting Airflow 2.x
v0.351.25¹, 1.26¹, 1.27, 1.28, 1.29, 1.30, 1.31¹11+All Runtime versions supporting Airflow 2.x
Due to the deprecation of Dockershim, Azure does not support private Certificate Authorities (CAs) starting with Kubernetes 1.19. If your organization is using a private CA, contact Astronomer support before upgrading to Kubernetes 1.19 on Azure Kubernetes Service (AKS).

¹ Support for some Kubernetes versions is limited to specific Astronomer Software patch versions. You can find the specific versions supported by a particular Software patch starting with version 0.32.4 in the Release index.

  • Support for Kubernetes 1.19 and 1.20 ends with Astronomer Software versions 0.28.7 and 0.29.5.
  • Support for Kubernetes 1.22 ends with Astronomer Software version 0.32.2.
  • Support for Kubernetes 1.23 ends with Astronomer Software version 0.32.4.
  • Support for Kubernetes 1.25 and 1.26 starts in Astronomer Software 0.31.2 and ends with 0.35.0.
  • Support for Kubernetes 1.27 starts in Astronomer Software 0.30.8.
  • Support for Kubernetes 1.28 starts in Astronomer Software 0.32.4. It is not available for version 0.33.0.
  • Support for Kubernetes 1.29 is available in Astronomer Software 0.32.6, and all versions greater than 0.33.6.
  • Support for Kubernetes 1.30 starts with Astronomer Software 0.34.4 and 0.35.1. It is not available for version 0.35.0.
  • Support for Kubernetes 1.31 starts with Astronomer Software 0.34.4 and 0.35.1. It is not available for version 0.35.0.