Skip to main content

Documentation Index

Fetch the complete documentation index at: https://astronomer-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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 theAstronomer 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.

​
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 thedeprecation of Dockershim, Azure does not support private Certificate Authorities (CAs) starting with Kubernetes 1.19. If your organization is using a private CA, contactAstronomer supportbefore 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.