Image variants

The following images are published in the DockerHub of Apache Airflow (assuming Airflow version 3.5.0):

  • apache/airflow:latest - the latest released Airflow image with default Python version (3.14 currently)

  • apache/airflow:latest-pythonX.Y - the latest released Airflow image with specific Python version

  • apache/airflow:3.5.0 - the versioned Airflow image with default Python version (3.14 currently)

  • apache/airflow:3.5.0-pythonX.Y - the versioned Airflow image with specific Python version

Those are “reference” regular images. They contain the most common set of extras, dependencies and providers that are often used by the users and they are good to “try-things-out” when you want to just take Airflow for a spin,

You can also use “slim” images that contain only core Airflow and are about half the size of the “regular” images. They are the recommended starting point for production: you add only the Reference for package extras and providers that you need, as shown in a small production image.

  • apache/airflow:slim-latest - the latest released Airflow image with default Python version (3.14 currently)

  • apache/airflow:slim-latest-pythonX.Y - the latest released Airflow image with specific Python version

  • apache/airflow:slim-3.5.0 - the versioned Airflow image with default Python version (3.14 currently)

  • apache/airflow:slim-3.5.0-pythonX.Y - the versioned Airflow image with specific Python version

Note

Database providers in slim images

Slim images come with the database clients preinstalled, but the default providers do not include any database provider. Install the provider for your database (for example apache-airflow-providers-postgres) yourself.

Naming conventions for the images:

Image

Python

Standard image

Slim image

Latest default

3.14

apache/airflow:latest

apache/airflow:slim-latest

Default

3.14

apache/airflow:X.Y.Z

apache/airflow:slim-X.Y.Z

Latest

3.11,3.12,3.13,3.14

apache/airflow:latest-pythonN.M

apache/airflow:slim-latest-pythonN.M

Specific

3.11,3.12,3.13,3.14

apache/airflow:X.Y.Z-pythonN.M

apache/airflow:slim-X.Y.Z-pythonN.M

The “latest” image is always the latest released stable version. Pin a specific X.Y.Z version in your own images, so that rebuilding them does not upgrade Airflow by surprise.

Was this entry helpful?