Are you using Apache Airflow for workflow automation? If so, you need to know exactly when your current version’s support ends. Many users overlook version End-of-Life (EOL/EOS) schedules, which can leave them without security updates or bug fixes when they need them most.

This guide covers Apache Airflow’s version support policy and provides detailed timelines for each version.

 

Apache Airflow

 

 

1. What is Apache Airflow?

Apache Airflow is an open-source platform for programmatically authoring, scheduling, and monitoring data pipelines and workflows. Started at Airbnb in 2014, it became an Apache Incubator project in 2016 and graduated to a top-level project in 2019.

Key Features:

  • Workflows as Code: Define data pipelines as DAGs (Directed Acyclic Graphs) using Python code
  • Dynamic Pipeline Generation: Create and parameterize pipelines dynamically through code
  • Extensibility: Hundreds of provider packages for connecting to cloud services, databases, and protocols
  • Rich User Interface: Web-based interface for visualizing and monitoring pipeline status

Currently, over 80,000 organizations use Airflow worldwide, with more than 30 million monthly downloads.

 

 

2. Understanding Airflow’s Version Support Policy

Since version 2.0, Apache Airflow follows Semantic Versioning (SemVer). Version numbers follow the MAJOR.MINOR.PATCH format.

Two Support Phases:

Apache Airflow operates with two distinct support phases. The first is Active Support, which includes new features along with bug fixes and security patches. This is followed by Limited Support, which provides only critical bug fixes and security patches.

After End-of-Life (EOL):

  • No fixes or support provided
  • No security patches even if vulnerabilities are discovered
  • Compatibility with new provider packages not guaranteed

 

 

3. Version Support Timeline at a Glance

Official Apache Airflow version lifecycle information from the Apache Airflow GitHub repository and official documentation.

VersionCurrent PatchSupport StatusFirst ReleaseLimited MaintenanceEOL/Terminated
3.x3.1.0SupportedApril 22, 2025TBDTBD
2.x2.11.0SupportedDecember 17, 2020October 22, 2025April 22, 2026
1.101.10.15EOLAugust 27, 2018December 17, 2020June 17, 2021
1.91.9.0EOLJanuary 3, 2018August 27, 2018August 27, 2018
1.81.8.2EOLMarch 19, 2017January 3, 2018January 3, 2018
1.71.7.1.2EOLMarch 28, 2016March 19, 2017March 19, 2017

⚠️ Critical Dates:

  • Airflow 2.x enters Limited Support on October 22, 2025 and reaches full EOL on April 22, 2026
  • All 1.x versions are already EOL

 

 

4. Detailed Airflow 2.x Minor Version Release History

Complete list of Airflow 2.x minor versions based on PyPI and official release notes.

Minor VersionRelease DateLatest PatchSupported PythonKey Features
2.11.0May 20, 20252.11.03.9, 3.10, 3.11, 3.12Airflow 3.0 migration tools, Python 3.8 EOL
2.10.5February 10, 20252.10.53.8, 3.9, 3.10, 3.11, 3.12Bug fixes and stabilization
2.10.0August 15, 20242.10.53.8, 3.9, 3.10, 3.11, 3.12Hybrid Executor, DatasetAlias
2.9.3July 16, 20242.9.33.8, 3.9, 3.10, 3.11, 3.12Patch updates
2.9.0April 8, 20242.9.33.8, 3.9, 3.10, 3.11, 3.12Python 3.12 support, MS SQL Server EOL
2.8.0December 18, 20232.8.43.8, 3.9, 3.10, 3.11Python 3.11 support, Debian Bookworm
2.7.0August 18, 20232.7.33.8, 3.9, 3.10, 3.11Stability improvements
2.6.0April 30, 20232.6.33.7, 3.8, 3.9, 3.10, 3.11Performance optimization
2.5.0December 2, 20222.5.33.7, 3.8, 3.9, 3.10, 3.11Quality of life improvements
2.4.0September 19, 20222.4.33.7, 3.8, 3.9, 3.10Various feature additions
2.3.0April 30, 20222.3.43.7, 3.8, 3.9, 3.10Datasets functionality
2.2.0October 11, 20212.2.53.6, 3.7, 3.8, 3.9Performance improvements
2.1.0May 21, 20212.1.43.6, 3.7, 3.8, 3.9Bug fixes and stabilization
2.0.0December 17, 20202.0.23.6, 3.7, 3.8Major release, Scheduler HA

⚠️ AWS MWAA Users: Amazon MWAA will end support for Airflow versions 2.4.3, 2.5.1, and 2.6.3 on December 30, 2025.

 

 

5. Airflow 3.x Version Details

Apache Airflow 3.0 is the most significant release since 2.0.

Minor VersionRelease DateSupported PythonMajor Changes
3.1.0September 25, 20253.10, 3.11, 3.12, 3.13Python 3.13 support, Python 3.9 EOL
3.0.6August 29, 20253.9, 3.10, 3.11, 3.12Bug fixes
3.0.0April 22, 20253.9, 3.10, 3.11, 3.12Major release, Task SDK, DAG Versioning

Key Features:

  • Task Execution Interface: Client-server architecture
  • Task SDK: Execute tasks in external systems
  • DAG Versioning: Lock DAG version during execution
  • Scheduler-managed Backfills: Enhanced backfill management
  • React-based UI: Modern, fast user interface

 

 

6. Python and Kubernetes Compatibility Matrix

Supported platforms in Airflow 3.1.0.

Python Version Compatibility

Airflow VersionPython 3.7Python 3.8Python 3.9Python 3.10Python 3.11Python 3.12Python 3.13
3.1.x
3.0.x
2.11.x
2.10.x
2.9.x
2.8.x
2.7.x
2.6.x
2.0-2.5

Database Compatibility

Officially supported databases by Airflow:

DatabaseSupported VersionsNotes
PostgreSQL13, 14, 15, 16, 17Recommended
MySQL8.0, 8.4, InnovationSupported
SQLite3.15.0+Development only
MariaDB❌ Not supported
MS SQL Server❌ EOL since Airflow 2.9.0

Kubernetes Version Compatibility

Kubernetes versions tested with Airflow 3.x:

Airflow VersionKubernetes Versions
3.x1.30, 1.31, 1.32, 1.33
2.x1.25, 1.26, 1.27, 1.28, 1.29

 

 

7. Upgrade Planning Guide

For Current Airflow 2.x Users

Airflow 2.x reaches full EOL on April 22, 2026. Plan your upgrade accordingly:

Upgrade Timeline:

PeriodStatusRecommended Action
Now – October 2025Active SupportStable usage, prepare for 3.0 migration
October 2025 – April 2026Limited SupportSecurity patches only, upgrade soon
After April 2026EOLSecurity risk, upgrade immediately

Step-by-Step Upgrade Strategy:

Step 1: Environment Check

# Check current version
airflow version

# Check Python version (3.9+ required)
python --version

# Check database version
# For PostgreSQL
psql --version

Step 2: Upgrade to 2.11 First

Airflow 2.11 includes tools to help with Airflow 3.0 migration.

# Validate configuration
airflow config lint

# Auto-update configuration
airflow config update

# Validate DAG code (using Ruff)
ruff check dags/ --select AIR301 --preview
ruff check dags/ --select AIR301 --fix --preview

Step 3: Upgrade to Airflow 3.0

# Verify Python 3.10+
python --version

# Install with constraints
pip install 'apache-airflow==3.0.6' \
  --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.0.6/constraints-3.10.txt"

Upgrade Checklist

ItemRequirements
Python Version3.10+ (for Airflow 3.1)
DatabasePostgreSQL 13+ or MySQL 8.0+
Provider PackagesCheck minimum Airflow version requirements
Custom CodeUpdate execution_datelogical_date
ConfigurationCheck removed/changed options
BackupDatabase and DAG files backup essential

 

 

8. Managed Service Version Support Policies

Cloud service Airflow version support schedules may differ from open source.

ServiceSupported VersionsNotesReference
AWS MWAA2.7.2, 2.8.1, 2.9.2, 2.10.32.4.3, 2.5.1, 2.6.3 EOL December 30, 2025Documentation
Google Cloud Composer2.x seriesSeparate support policyDocumentation
Azure Data FactoryManaged Airflow integrationSeparate version policyDocumentation

 

 

Understanding Apache Airflow’s version support timeline is fundamental to maintaining stable data pipelines.

Key Takeaways:

  • Airflow 2.x: Limited Support starts October 22, 2025, full EOL April 22, 2026
  • Airflow 3.x: Currently stable, long-term support expected
  • Upgrade Path: Recommended sequence: 2.7+ → 2.11 → 3.x
  • Python Support: 3.x supports Python 3.10-3.13
  • Cloud Services: Check provider-specific support schedules

Useful Resources:

Check your Airflow version today to ensure your environment is properly maintained.

 

 

Leave a Reply