Astro Runtime release notes

Astro Runtime is a Docker image built and published by Astronomer that extends the Apache Airflow project to provide a differentiated data orchestration experience. This document provides a summary of changes made to each available version of Astro Runtime.

To upgrade Astro Runtime, see either Upgrade Astro Runtime or Upgrade Astro Private Cloud Runtime. For general product release notes, see Astro Release Notes. If you have any questions or a bug to report, contact Astronomer support.

For release notes and provider package reference of Astro Runtime versions 10.x and older, see Astro Runtime docs archive.

Because Astronomer has separate maintenance life cycles for each major version of Astro Runtime, the same change can be introduced multiple times across major versions, resulting in multiple identical release notes. When a new major version releases, such as Astro Runtime 8.0.0, all changes from previously released versions are included in the new major version.

If you’re upgrading to receive a specific change, ensure the release note for the change appears either:

  • Within your target major version.
  • In any minor or patch version that was released before the first release (X.0.0) of your target major version. For example, a change in Astro Runtime 9.9.0, which released January 10 2024, is not guaranteed to appear in Runtime 10.0.0, which released December 8 2023, unless there is a release note for it in a subsequent Runtime 10 patch. However, a change in Astro Runtime 9.6.0, which released November 30 2023, is guaranteed to exist in Runtime 10.0.0 because 9.6.0 was released prior to 10.0.0.

Astro Runtime 3.1-6

  • Release date: December 03, 2025
  • Airflow version: 3.1.3
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.1-6

Additional improvements

  • Upgraded to Airflow 3.1.3+astro.2, which includes:
    • Fix TypeError in parseStreamingLogContent for non-string data (#58314)
  • Upgrade to Apache Airflow TaskSDK to 1.1.3+astro.2
    • Redact secrets in rendered templates properly to not expose them on UI (#58767)
    • Mask secrets properly when using deprecated import path (#58662)
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.1-6 provider packages.
  • Enforce SQLAlchemy==1.4.54, even when users extend the image

Astro Runtime 3.1-5

  • Release date: November 14, 2025
  • Airflow version: 3.1.3
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.1-5

Additional improvements

  • Upgraded to Airflow 3.1.3+astro.1, which includes:
    • Bug fixes
    • Fix atomicity issue in SerializedDagModel.write_dag preventing orphaned DagVersions (#58281)
  • Upgraded to Apache Airflow TaskSDK to 1.1.3+astro.1

Astro Runtime 3.1-4

  • Release date: November 06, 2025
  • Airflow version: 3.1.2
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.1-4

Additional improvements

  • Upgraded to Airflow 3.1.2+astro.1, which includes:
    • Bug fixes
    • Ensure that DB migrations handles all kinds of NaN values in historical xcoms (#57893)
    • Revert “Fix text selection jumping in logs pane to match text editor behavior (#57309)” (#57874)
  • Upgraded to Apache Airflow TaskSDK to 1.1.2+astro.1
    • Ensure task in the context is always correct (#57892)
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.1-4 provider packages.

Security fixes

Astro Runtime 3.1-3

  • Release date: October 27, 2025
  • Airflow version: 3.1.1
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.1-3

Additional improvements

  • Upgraded to Airflow 3.1.1+astro.1, which includes:
    • Bug fixes
  • Fix memory leak in Client via SSL context creation (#57334)
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.1-3 provider packages.

Security fixes

Astro Runtime 3.1-2

  • Release date: October 09, 2025
  • Airflow version: 3.1.0
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.1-2
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Additional improvements

  • Upgraded to Airflow 3.1.0+astro.2, which includes:

    • Fix scheduler crash with email notifications (#56429)
    • Emit log stream stopped warning as ndjson (#56474)

  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.1-2 provider packages.

Astro Runtime 3.1-1

  • Release date: September 26, 2025
  • Airflow version: 3.1.0
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.1-1
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Introducing Airflow 3.1

Astro Runtime 3.1-1 includes support for Apache Airflow 3.1, which includes a number of new features and improvements. Airflow 3.1 includes the following changes:

  • Human-in-the-loop: Bridge between fully automated processes and human expertise
  • Many UI enhancements:
    • Internationalization with 17 supported languages
    • Calendar and gantt views
    • Robust plugin support
  • Deadline alerts

For more information about the major changes in this release, see the Airflow Blog or the Airflow release notes.

Additional improvements

  • Upgraded to Airflow 3.1.0+astro.1, which includes:
    • New features and improvements in Airflow 3.1.0
    • Enhanced performance and stability
    • Bug fixes
  • Upgraded the versions of many open-source provider packages. See Astro Runtime 3.1-1 provider packages.

Behavior change

This Runtime version introduces a new default behavior that could cause breaks depending on your configurations.

Astro Runtime 3.0-13

  • Release date: October 30, 2025
  • Airflow version: 3.0.6
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-13

Additional improvements

  • Upgraded to Airflow 3.0.6+astro.4, which includes:
    • Fix DAG processor crash with pre-import module optimization (#56773)
    • Prevent unnecessary kubernetes client imports in workers (#56692)
  • Upgraded Apache Airflow TaskSDK to 1.0.6+astro.2which includes:
    • Fix memory leak in remote logging connection cache (#56695)
    • Fix memory leak in Client via SSL context creation (#57334)
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.0-13 provider packages.

Security fixes

Astro Runtime 3.0-12

  • Release date: September 24, 2025
  • Airflow version: 3.0.6
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-12
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Additional improvements

  • Upgraded to Airflow 3.0.6+astro.3, which includes:
    • Handle trigger calls to get_connection (#55799)
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.0-12 provider packages.

Astro Runtime 3.0-11

  • Release date: September 17, 2025
  • Airflow version: 3.0.6
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-11
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Additional improvements

  • Upgraded to Airflow 3.0.6+astro.2, which includes:
    • Fix query client retry strategy (#55528)
    • Fix FAB related db downgrade issues (#55738), (#55231)
    • Reduce default API server workers to 1 (#55707)
    • Remove python_callable as string from mapped operator in serialized dag (#55288)
    • Minor optimizations to serialized dag storage and retrieval to reduce size

Astro Runtime 3.0-10

  • Release date: August 29, 2025
  • Airflow version: 3.0.6
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-10
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Additional improvements

Astro Runtime 3.0-9

  • Release date: August 21, 2025
  • Airflow version: 3.0.5
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-9
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Restricted version

Airflow 3.0.5 was yanked due to a bug with conn.extra_dejson masking that causes tasks to fail (#54768).

This means that the Astro Runtime 3.0-9 is also yanked. See Restricted Runtime versions.

Astro Runtime 3.0-8

  • Release date: August 19, 2025
  • Airflow version: 3.0.4
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-8
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Additional improvements

  • Upgrade to Airflow 3.0.4+astro.2, which includes:
    • Fix scheduler crashes with DetachedInstanceError when processing executor events. #54334
    • Fix DetachedInstanceError when accessing DagRun.created_dag_version. #54362
    • Fix custom XCom backends not being used when BaseXCom.get_all() is called. #53814
    • Fix xcom_pull ignoring include_prior_dates parameter when map_indexes is not specified. #53809
    • Restore get_previous_dagrun functionality for task context. #53655
    • Fix log retrieval failures for in-progress tasks by properly configuring JWT authentication. #54444
  • Upgrade to Apache Airflow Task SDK 1.0.4+astro.2, which includes:
    • Fix custom XCom backends not being used when BaseXCom.get_all() is called. #53814
    • Fix xcom_pull ignoring include_prior_dates parameter when map_indexes is not specified. #53809
    • Restore get_previous_dagrun functionality for task context. #53655
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.0-8 provider packages.
  • Fixed CVE-2025-53643 for AIOHTTP vulnerable by upgrading to version 3.12.14.
  • Fixed CVE-2025-54368 for uv by upgrading to version 0.8.6.

Astro Runtime 3.0-7

  • Release date: August 08, 2025
  • Airflow version: 3.0.4
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-7
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Additional improvements

  • Upgraded to Airflow 3.0.4. See Airflow Release Notes for more information.
  • Upgraded Apache Airflow TaskSDK to 1.0.4+astro.1.
  • Upgraded astronomer-logging-providers==1.6.4 which enables exporting the logs to secondary GCS bucket.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.0-7 provider packages.

Astro Runtime 3.0-6

  • Release date: July 24, 2025
  • Airflow version: 3.0.3
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-6
Known Issue

This version of Runtime has a significant memory leak for Celery Workers. Astronomer recommends upgrading directly to Runtime 3.1-3 or switching to Astro Executor.

Additional improvements

  • Upgraded to Airflow 3.0.3+astro.2, which includes:
    • Skips empty dag-run config rows and raises the SQL timeout for XCom migrations to avoid lock-timeout errors. #50788
    • Fixes sensor skipping in 3.x branching operators by correcting the SkipMixin import path. #53455
    • Triggers task-failure callbacks on the Dag processor when tasks are externally killed. #53143
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.0-6 provider packages.

Security fixes

Astro Runtime 3.0-5

  • Release date: July 14, 2025
  • Airflow version: 3.0.3
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-5

Additional improvements

Astro Runtime 3.0-4

  • Release date: June 12, 2025
  • Airflow version: 3.0.2
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-4

Bug fixes

  • Fixed various bugs in AstroAuthManager.
  • Fixed text alignment of Back to Astro button.

Astro Runtime 3.0-3

  • Release date: June 10, 2025
  • Airflow version: 3.0.2
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-3

Additional improvements

Astro Runtime 3.0-2

  • Release date: May 12, 2025
  • Airflow version: 3.0.1
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-2

Additional improvements

  • Added SCARF_NO_ANALYTICS=True in Runtime images to disable telemetry by default.
  • Updated astronomer-providers-logging to 1.6.1.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 3.0-2 provider packages

Known issues

Remote execution has a known incompatibility with Runtime 3.0-2. If you use remote execution, do not upgrade to or create Remote Deployments that use this version. A fix for the incompatibility will be released in v3.0-3.

If you created a new remote Deployment with 3.0-2, you cannot rollback to 3.0-1. You must either create a new remote Deployment with 3.0-1 or wait until the 3.0-3 patch and then upgrade.

If you upgraded a Deployment from 3.0-1 to 3.0-2, Astronomer advises you to downgrade your Deployments or rollback to 3.0-1 by using a Dockerfile change or by rolling back your Deployment in the Astro UI.

Astro Runtime 3.0-1

  • Release date: April 22, 2025
  • Airflow version: 3.0.0
  • Python versions: 3.11 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/runtime:3.0-1

Introducing Airflow 3.0

Astro Runtime 3.0-1 includes same-day support for Apache Airflow 3.0, which includes a number of new features and improvements. Airflow 3.0 includes the following changes:

  • Support for dag versioning
  • Enhanced and improved React-based Airflow UI
  • Support for remote dag execution
  • Scheduler-managed backfill
  • Event-driven and asset-driven scheduling

For more information about the major changes in this release, see the Airflow release notes.

Behavior changes

  • New naming convention for Runtime release versions. Previously, versions were noted as XX.X.X, now versions are named as XX.X-X.
  • Astro Runtime for 3.0 and higher includes only the provider packages required to run on Astro. Previous versions contained additional providers, and if you are using those providers you must explicitly add them to your requirements.txt.
  • Runtime docs for versions that are past their End of Basic Support date, below v6.0.0, have been moved to the Astronom Docs Resources archive.
  • The Docker registry URL for Runtime images has changed for Airflow 3.x. For details, see Docker Registry URL changes.

Pip package resolution

With Runtime 3.0, Python package resolution has switched by default from pip to uv, which is intended as a fast drop in replacement for pip. However, uv has a different behavior for packages that exist on multiple indexes, because pip’s behavior is unsafe against dependency confusion attacks. If you rely on the pip behavior, you can add # ASTRO_RUNTIME_USE_PIP to your requirements.txt file to use pip instead of uv. You can also opt to install your dependencies in a separate RUN line on your Dockerfile instead of using Runtime’s built-in pip installation.

Docker Compose override changes

When using astro dev start, you can specify a docker-compose.override.yml. If you specified any overrides for the webserver container, these break your ability to use astro dev start because there is no longer a webserver container. Replace all references to webserver with api-server.

Docker Registry URL changes

Starting with Airflow 3.x, Runtime Docker images are hosted at a new registry:

astrocrpublic.azurecr.io/runtime:<version>

Airflow 2.x images are still available under the original registry:

quay.io/astronomer/astro-runtime:<version>

but can also be pulled from the new domain as an alternative:

astrocrpublic.azurecr.io/astronomer/astro-runtime:<version>

Astro Runtime 13.3.0

  • Release date: December 03, 2025
  • Airflow version: 2.11.0
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:13.3.0

Additional improvements

  • Updated astronomer-kubernetes-executor to version 10.8.1+astro.1.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 13.3.0 provider packages.
  • Upgrade astronomer-airflow-scripts to 0.0.8

Security fixes

Astro Runtime 13.2.0

  • Release date: September 04, 2025
  • Airflow version: 2.11.0
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:13.2.0

Additional improvements

  • Upgrade to Airflow 2.11.0+astro.3 which includes:
    • Make CronTriggerTimetable startup behavior intuitive. #41558
    • Timetable that runs on multiple cron expressions. #46451
    • Fix MultipleCronTriggerTimetable deserialization. #46886
  • Update astronomer-kubernetes-executor to 10.7.0+astro.1.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 13.2.0 provider packages.

Security fixes

Astro Runtime 13.1.0

  • Release date: July 02, 2025
  • Airflow version: 2.11.0
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:13.1.0

Additional improvements

  • Stop streaming task logs if the end of log mark is missing #50715
  • Correctly treat re-queues on reschedule sensors as resets after each reschedule #51410
  • Fix archival for cascading deletes by archiving dependent tables first #51952
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 13.1.0 provider packages.

Astro Runtime 13.0.0

  • Release date: May 20, 2025
  • Airflow version: 2.11.0
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:13.0.0

Additional improvements

  • Upgrade to Airflow 2.11.0+astro.1.
  • Update astronomer-providers-logging to 1.6.2. This adds support for writing task logs to a secondary S3 bucket.
  • Fix get_health endpoint to return None for inactive standalone Dag processors, preventing them from being reported as unhealthy.
  • Upgraded the major, minor, and patch versions of several open-source provider packages. See Astro Runtime 13.0.0 provider packages. As this release includes major provider updates, this release introduces breaking changes in dags. These issues can be resolved by updating provider-specific changes in the dags.

Astro Runtime 12.11.0

  • Release date: December 03, 2025
  • Airflow version: 2.10.5
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.11.0

Additional improvements

  • Updated astronomer-kubernetes-executor to version 10.7.0+astro.1.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 12.11.0 provider packages.
  • Upgrade astronomer-airflow-scripts to 0.0.8

Astro Runtime 12.10.0

  • Release date: July 02, 2025
  • Airflow version: 2.10.5
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.10.0

Additional improvements

  • Stop streaming task logs if the end of log mark is missing #50715
  • Correctly treat re-queues on reschedule sensors as resets after each reschedule #51410
  • Fix archival for cascading deletes by archiving dependent tables first #51952
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 12.10.0 provider packages.

Astro Runtime 12.9.0

  • Release date: May 05, 2025
  • Airflow version: 2.10.5
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.9.0

Additional improvements

  • Add SCARF_NO_ANALYTICS=True in Runtime images to disable telemetry by default.
  • Update astronomer-providers-logging to 1.6.0.
  • Update astronomer-kubernetes-executor to 10.4.2+astro.1 to allow internal retries when a pending Kubernetes Pod is deleted.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 12.9.0 provider packages

Astro Runtime 12.8.0

  • Release date: April 10, 2025
  • Airflow version: 2.10.5
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.8.0

Additional improvements

  • Upgraded apache-airflow-providers-celery==3.10.0 to apache-airflow-providers-celery==3.10.5
  • Upgraded celery==5.4.0 to celery==5.5.0.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 12.8.0 provider packages

Astro Runtime 12.7.1

  • Release date: February 19, 2025
  • Airflow version: 2.10.5
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.7.1

Early access Airflow bug fixes

  • Improved CronTriggerTimetable startup behavior #41558
  • Introduced MultipleCronTriggerTimetable that allows scheduling dag runs based on multiple cron expressions #46451

Additional improvements

Astro Runtime 12.7.0

  • Release date: February 11, 2025
  • Airflow version: 2.10.5
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.7.0

Additional improvements

Astro Runtime 12.6.0

  • Release date: December 16, 2024
  • Airflow version: 2.10.4
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.6.0

Additional improvements

Astro Runtime 12.5.0

  • Release date: December 02, 2024
  • Airflow version: 2.10.3
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.5.0

RHEL UBI 9 images are officially supported

RHEL UBI 9 images are now officially supported starting with version 12.5. In addition, the following changes have been made since the initial release:

  • Removed Packages: glibc, krb5-libs, systemd-sysv, wget, lz4, libicu
  • PostgreSQL installation is now sourced from the UBI repository instead of download.postgresql.org
  • The EPEL repository has been removed from the UBI image

Early access Airflow bug fixes

  • You can now retry tasks that are stuck in queued state #43520

Additional improvements

Astro Runtime 12.4.0

  • Release date: November 15, 2024
  • Airflow version: 2.10.3
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.4.0

Additional improvements

Astro Runtime 12.3.0

  • Release date: November 06, 2024
  • Airflow version: 2.10.3
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.3.0

Additional improvements

Astro Runtime 12.2.0

  • Release date: October 16, 2024
  • Airflow version: 2.10.2
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.2.0

Early access Airflow bug fixes

  • Fixed a bug where the executor would not clean up terminated task instances that go too long without a heartbeat #43065
  • Fixed a bug that caused StaleDataError by using a different session for writing and deleting recent task instance failures #42928

Additional improvements

Astro Runtime 12.1.1

  • Release date: September 20, 2024
  • Airflow version: 2.10.2
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.1.1

Additional improvements

Astro Runtime 12.1.0

  • Release date: September 06, 2024
  • Airflow version: 2.10.1
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.1.0

Additional improvements

Security fixes

Astro Runtime 12.0.0

  • Release date: August 16, 2024
  • Airflow version: 2.10.0
  • Python versions: 3.10 - 3.12 (default: 3.12)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:12.0.0

Airflow 2.10.0

Astro Runtime 12.0.0 includes same-day support for Apache Airflow 2.10, which includes a number of new features and improvements. Airflow 2.10 includes the following changes:

  • Adds decorators for task flow (@skip_if, @run_if) to make it easier to apply whether or not to skip a task.
  • You can now see TaskInstance Try History in the Airflow UI
  • Enable ending the task directly from the triggerer without going into the worker.
  • Extended dataset dependencies to support dynamic Dataset Event Emission and Dataset Creation.
  • A new object, DatasetAlias, is available to support dynamic Dataset Event Emission and Dataset Creation (#40478)
  • Implement accessors to read dataset events defined as inlet (#39367)

For more information about the major changes in this release, see the Airflow Blog or the Airflow release notes.

Additional improvements

  • Updated OS to Debian 12.6 (bookworm)
  • Updated Python version to 3.12 in default image
  • Upgraded the minor and patch versions of some open-source provider packages. See Astro Runtime 12.0.0 provider packages

Behavior change

  • Since Airflow 2.10 uses Python 3.12, some Python modules have reached end of life, like imp, that might create errors in your dags if you still use them. See Upgrade considerations: Runtime 12 for more information.

Astro Runtime 11.20.0

  • Release date: October 13, 2025
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.20.0

Additional improvements

  • Upgraded to Airflow 2.9.3+astro.13, which includes:
    • Fix try_number in backport of #51410

Security fixes

Astro Runtime 11.19.0

  • Release date: July 02, 2025
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.19.0

Additional improvements

  • Stop streaming task logs if the end of log mark is missing #50715
  • Correctly treat re-queues on reschedule sensors as resets after each reschedule #51410
  • Fix archival for cascading deletes by archiving dependent tables first #51952
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 11.19.0 provider packages.

Astro Runtime 11.18.0

  • Release date: May 05, 2025
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.18.0

Additional improvements

  • Add SCARF_NO_ANALYTICS=True in Runtime images to disable telemetry by default.
  • Upgraded apache-airflow-providers-celery==3.10.0 to apache-airflow-providers-celery==3.10.6
  • Upgraded celery==5.4.0 to celery==5.5.0.
  • Update astronomer-kubernetes-executor to 10.4.2+astro.1 to allow internal retries when a pending Kubernetes Pod is deleted.
  • Upgraded the minor and patch versions of several open-source provider packages. See Astro Runtime 11.18.0 provider packages

Astro Runtime 11.17.0

  • Release date: February 26, 2025
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.17.0

Early access Airflow bug fixes

  • Improved CronTriggerTimetable startup behavior #41558
  • Introduced MultipleCronTriggerTimetable that allows scheduling dag runs based on multiple cron expressions #46451
  • Mask connection details when creating connections using JSON or URI to ensure consistency with other methods #46595

Additional improvements

Astro Runtime 11.16.0

  • Release date: January 21, 2025
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.16.0

Early access Airflow bug fixes

  • Fixed a bug where the executor would not clean up terminated task instances that go too long without a heartbeat #42932

Additional improvements

Astro Runtime 11.15.1

  • Release date: December 06, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.15.1

Early access Airflow bug fixes

  • Restore add_input_dataset and add_output_dataset in NoOpCollector for backward compatibility. #44681

Astro Runtime 11.15.0

  • Release date: December 02, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.15.0

Early access Airflow bug fixes

  • You can now retry tasks that are stuck in queued state #43520

Additional improvements

Astro Runtime 11.14.0

  • Release date: November 15, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.14.0

Early access Airflow bug fixes

  • Improved handling value masking of the set variable #43123
  • Masked configuration values that are irrelevant to the dag author #43040

Additional improvements

Astro Runtime 11.13.0

  • Release date: October 31, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.13.0

Additional improvements

Astro Runtime 11.12.0

  • Release date: October 25, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.12.0

Early access Airflow bug fixes

  • Revert “Fix: Dags are not marked as stale if the dags folder change” #42197
  • Revert “Handle Example dags case when checking for missing files” #42193

Additional improvements

Astro Runtime 11.11.0

  • Release date: October 03, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.11.0

Early access Airflow bug fixes

  • Fixed a bug in the check served logs logic that caused the UI to show an erroneous 404 error if the user was looking at the logs for a non-running try #41272
  • Fixed a bug where clicking on a run_id in a task_instance or dag_run list incorrectly opened a different run_id #42138

Additional improvements

Astro Runtime 11.10.1

  • Release date: September 06, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.10.1

Additional improvements

Security fixes

Astro Runtime 11.10.0

  • Release date: September 02, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.10.0

Additional improvements

Bug fixes

  • Resolved a dag parsing issue where dags were not marked as stale if the AIRFLOW__CORE__DAGS_FOLDER was changed. (#41433)
  • LocalTaskJob no longer fails on heartbeat due to temporary database connection losses. (#41704)

Astro Runtime 11.9.0

  • Release date: August 15, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.9.0

Additional improvements

  • Downgrade apache-airflow-providers-openlineage to 1.8.0 to prevent scheduler OOM with complex dags

Astro Runtime 11.8.0

  • Release date: August 09, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.8.0

Additional improvements

  • Fixed the Tasks API endpoint for scenarios when a dag doesn’t have a start_date (#40878)
  • Added validation for the project URL that comes from installed providers, before displaying the URL in views (#40933)
  • Upgraded the minor and patch versions of some open-source provider packages. See Astro Runtime 11.8.0 provider packages

Astro Runtime 11.7.0

  • Release date: July 17, 2024
  • Airflow version: 2.9.3
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.7.0

Airflow 2.9.3

Astro Runtime 11.7.0 includes same-day support for Apache Airflow 2.9.3. Airflow 2.9.3 contains a number of bug fixes and new features including:

  • The time unit for scheduled_duration and queued_duration metrics has changed to milliseconds instead of seconds #37936
  • Support for OpenTelemetry metrics on Airflow are now considered Stable, and was previously added in Airflow version 2.7.0 as Experimental #40286

For more information, see the Apache Airflow release notes.

Additional improvements

Security fixes

Astro Runtime 11.6.0

  • Release date: June 28, 2024
  • Airflow version: 2.9.2
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.6.0

Early access Airflow bug fixes

  • Fixed a bug where FAB config options, such as [fab] update_fab_perms, were not checking for values in the deprecated webserver config section. For example, [webserver] update_fab_perms (#40317)

Additional improvements

Astro Runtime 11.5.0

  • Release date: June 11, 2024
  • Airflow version: 2.9.2
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.5.0

Airflow 2.9.2

Astro Runtime 11.5.0 includes same-day support for Apache Airflow 2.9.2. Airflow 2.9.2 contains a number of bug fixes including:

  • Resolved a bug where valid dags that worked in Airflow 2.8 and had outlet datasets with specific URIs stopped working depending on how the URI was formatted (#39670)
  • Resolved an issue where the object storage XCOM backend did not serialize correctly, causing custom XCOM backends to sometimes fail (#39313)

For more information, see the Apache Airflow release notes.

Additional improvements

Security fixes

Astro Runtime 11.4.0

  • Release date: May 28, 2024
  • Airflow version: 2.9.1
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.4.0

Additional improvements

Astro Runtime 11.3.0

  • Release date: May 06, 2024
  • Airflow version: 2.9.1
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.3.0

Early access Airflow bug fixes

  • Fixed a bug affecting custom actions in Airflow plugins that prevents users from running an Astro Runtime environment locally for Astro Runtime versions 11.0.0-11.2.0. Deployments running these versions on Astro are not affected. To continue using 11.0.0-11.2.0 locally, set AIRFLOW__ASTRONOMER__UPDATE_CHECK_INTERVAL=0 in your Astro project .env file (#39421)

Additional improvements

  • Upgraded some OSS providers’ minor and patch versions

Security fixes

Astro Runtime 11.2.0

  • Release date: April 26, 2024
  • Airflow version: 2.9.0
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.2.0
Due to an issue related to using custom FAB actions in Airflow plugins, you might experience an error when you run this version of Astro Runtime locally using the Astro CLI. To resolve this issue, either upgrade directly to Astro Runtime 11.3.0 or set AIRFLOW__ASTRONOMER__UPDATE_CHECK_INTERVAL=0 in your Astro project .env file.

Early access Airflow bug fixes

  • Fixed a bug where airflow db migrate would throw an error (#39246)

Additional improvements

Security fixes

Astro Runtime 11.1.0

  • Release date: April 19, 2024
  • Airflow version: 2.9.0
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.1.0
Due to an issue related to using custom FAB actions in Airflow plugins, you might experience an error when you run this version of Astro Runtime locally using the Astro CLI. To resolve this issue, either upgrade directly to Astro Runtime 11.3.0 or set AIRFLOW__ASTRONOMER__UPDATE_CHECK_INTERVAL=0 in your Astro project .env file.

Additional improvements

  • Updated sqlparse to 0.5.0.
  • Upgraded Gunicorn to 22.0.0.
  • Added functionality for using plugins to generate custom menu items in the Airflow UI. This feature will be fully available on Astro in a future release.

Astro Runtime 11.0.0

  • Release date: April 08, 2024
  • Airflow version: 2.9.0
  • Python versions: 3.9 - 3.11 (default: 3.11)
  • Runtime image: astrocrpublic.azurecr.io/astronomer/astro-runtime:11.0.0
Due to an issue related to using custom FAB actions in Airflow plugins, you might experience an error when you run this version of Astro Runtime locally using the Astro CLI. To resolve this issue, either upgrade directly to Astro Runtime 11.3.0 or set AIRFLOW__ASTRONOMER__UPDATE_CHECK_INTERVAL=0 in your Astro project .env file.

Airflow 2.9.0

Astro Runtime 11.0.0 includes same-day support for Apache Airflow 2.9, which includes a number of new features and improvements. Airflow 2.9 includes the following changes:

  • New data-aware scheduling lets you use conditional logic (AND / OR) to schedule dags.
  • You can now create your own labels for dynamically mapped tasks with templates, which makes it easier to search through mapped task instances.
  • External XCom backends can now be configured to use object storage.
  • Delivered several significant improvements to the Airflow UI. For example, you can now filter, view, and create datasets through the Airflow UI.
  • New Listener API methods are considered stable and suitable for use in production.
  • Added the ability to automatically pause a dag after a pre-defined number of sequentially failed runs.
  • Dataset URIs are validated when you enter them, and must conform to the rules set in AIP-60. See the Dataset documentation for more information.

For more information about the major changes in this release, see the Airflow Blog or the Airflow release notes.

Upgrade to Python 3.12

Airflow now supports Python 3.12. However, Pendulum 2 does not support Python 3.12. If you upgrade to Python 3.12 and want to use Airflow, you also need to upgrade to Pendulum 3.

Refer to the Airflow release notes for more information about any limitations in Python 3.12 support.

Bug fixes

  • Fixed a bug where after a task failed, and no longer exists in a dag, you can now still access details about the dag in the Grid View of the Airflow UI.
  • Fixed a bug where Airflow would show failed_upstream when a dynamically mapped task was skipped.
  • In the Python task decorator, you can only have None as the default parameter for context parameters.