Skip to content

Switch official Docker images to Debian Trixie - #71650

Draft
ytoprakc wants to merge 1 commit into
apache:mainfrom
ytoprakc:docker-images-debian-trixie
Draft

Switch official Docker images to Debian Trixie#71650
ytoprakc wants to merge 1 commit into
apache:mainfrom
ytoprakc:docker-images-debian-trixie

Conversation

@ytoprakc

Copy link
Copy Markdown
Contributor

Update Airflow’s Docker image base from Debian Bookworm to Debian Trixie.

Airflow’s documented base OS policy says the project switches released images to the latest supported Debian stable version approximately six months before the previous stable version reaches the end of regular support. Debian Bookworm regular support ended on July 11, 2026, so the Docker image base should now move forward to Debian Trixie.

This PR updates the Docker image build defaults, Breeze image build defaults, CI workflow inputs, and Docker stack documentation/examples from Bookworm to Trixie. It also records the change in the Docker image changelog and adds a significant newsfragment because this is user-visible for anyone pulling, extending, or rebuilding Airflow images.

closes: #71494

What changed:

  • Updated production and CI image defaults to use debian:trixie-slim.
  • Restricted supported Debian image builds in Breeze to trixie.
  • Updated image build workflows to default to trixie.
  • Updated Docker stack docs, examples, and build references from Bookworm to Trixie.
  • Updated Debian installation/security docs to describe Trixie as the reference Debian platform.
  • Added Docker image changelog and release-note coverage for the base image migration.
  • Added a Breeze regression test to assert the Debian image default remains Trixie.

Was generative AI tooling used to co-author this PR?
  • Yes — OpenAI Codex

Generated-by: OpenAI Codex following the guidelines


  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

@boring-cyborg boring-cyborg Bot added area:dev-tools area:production-image Production image improvements and fixes backport-to-v3-3-test Backport to v3-3-test kind:documentation labels Aug 15, 2026
@ytoprakc
ytoprakc force-pushed the docker-images-debian-trixie branch from 0ddb194 to cbdf5d2 Compare August 15, 2026 09:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-tools area:production-image Production image improvements and fixes backport-to-v3-3-test Backport to v3-3-test kind:documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Upgrading docker images debian from version 12(bookworm) to 13(trixie).

1 participant