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 versionapache/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 versionapache/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.