You can download the Docker base image for your Flex Templates
from the following repositories:

- [Java11 base images](https://gcr.io/dataflow-templates-base/java11-template-launcher-base)
- [Java17 base images](https://gcr.io/dataflow-templates-base/java17-template-launcher-base)
- [Java21 base images](https://gcr.io/dataflow-templates-base/java21-template-launcher-base)
- [Java25 base images](https://gcr.io/dataflow-templates-base/java25-template-launcher-base)
- [Python3 base images](https://gcr.io/dataflow-templates-base/python3-template-launcher-base)
- [Python311 base images](https://gcr.io/dataflow-templates-base/python311-template-launcher-base)
- [Python312 base images](https://gcr.io/dataflow-templates-base/python312-template-launcher-base)
- [Python313 base images](https://gcr.io/dataflow-templates-base/python313-template-launcher-base)
- [Python314 base images](https://gcr.io/dataflow-templates-base/python314-template-launcher-base)
- [Go base images](https://gcr.io/dataflow-templates-base/go-template-launcher-base)

For specific versions of Java and Go, you can choose images that are based
on [Distroless](https://github.com/GoogleContainerTools/distroless).
Distroless images are smaller and include only the required components to run Flex Templates.

- [Java11 Distroless base images](https://gcr.io/dataflow-templates-base/java11-template-launcher-base-distroless)
- [Java17 Distroless base images](https://gcr.io/dataflow-templates-base/java17-template-launcher-base-distroless)
- [Java21 Distroless base images](https://gcr.io/dataflow-templates-base/java21-template-launcher-base-distroless)
- [Java25 Distroless base images](https://gcr.io/dataflow-templates-base/java25-template-launcher-base-distroless)
- [Go Distroless base images](https://gcr.io/dataflow-templates-base/go-template-launcher-base-distroless)

Deprecated Docker base images:

- [Java8 base images](https://gcr.io/dataflow-templates-base/java8-template-launcher-base)
- [Python38 base images](https://gcr.io/dataflow-templates-base/python38-template-launcher-base)
- [Python39 base images](https://gcr.io/dataflow-templates-base/python39-template-launcher-base)
- [Python310 base images](https://gcr.io/dataflow-templates-base/python310-template-launcher-base)

> [!NOTE]
> **Note:** To ensure security and reduce vulnerability risks, always use Distroless base images. If the available images don't align with your specific needs, we recommend that you [use a custom container image](https://docs.cloud.google.com/dataflow/docs/guides/templates/configuring-flex-templates.md.txt#use_custom_container_images).

To download a Docker base image for your Flex Template,
go to the relevant image repository for a supported Python or Java
version and use the **Filter** field to search for an image tag.

The following table contains the tags of Docker base images for Flex Templates.
In the image repository, the image with the `latest` tag is the official
release and the image that we recommend using. Images released at later dates
are not yet reviewed.

> [!NOTE]
> **Note:** Upstream Apache Beam Python images recently changed
> their compression format to `zstd`. If you encounter
> Cloud Build errors while building templates, such as
> `Error processing tar file(exit status 1): archive/tar: invalid tar header`,
> see the Python tab for details and update to the latest version of the
> Google Cloud CLI (version 591.0.0 or later). As a workaround, you can also use an earlier Flex Templates base image release.

### Java

| Tag | Release note |
|---|---|
| `20261104-RC00` (latest) | Security fixes. |
| `20261026-RC00` | Security fixes and Beam version update. |
| `20261006-RC00` | Security fixes. |
| `20260901-RC00` | Security fixes. |
| `20260803-RC00` | Security fixes. |
| `20260730_RC00` | Security fixes. |
| `20260720_RC00` | Security fixes. |
| `20260713_RC01` | Security fixes and Beam version update. |
| `20260603_RC00` | Security fixes and Beam version update. |
| `20260504_RC00` | Security fixes and Beam version update. |
| `20260427_RC00` | Security fixes. |
| `20260126_RC00` | Security fixes. |
| `20260122_RC00` | Security fixes and Beam version update. |
| `20260105_RC00` | Security fixes and Beam version update. |
| `20251006_RC00` | Security fixes and Beam version update. |
| `20250923_RC00` | Security fixes. |
| `20250825_RC00` | Security fixes. |
| `20250707_RC00` | Security fixes and Beam version update. As of this version the Java8 container is no longer updated. |
| `20250514_RC00` | Security fixes. |
| `20250402_RC00` | Security fixes. |
| `20250220_RC00` | Security fixes. |
| `20250124_RC00` | Security fixes. |
| `20241127_RC00` | Security fixes. |
| `20240918_RC00` | Security fixes. Fixed an issue where pipeline options did not support non-ASCII characters. |
| `20240812_RC01` | Security fixes. |
| `20240506_RC00` | Security fixes. |
| `20240325_RC00` | Security fixes. |
| `20230622_RC00` | Security fixes, added Distroless alternative images. |
| `20230220_RC00` | Security fixes. |
| `20221018_RC00` | Security fixes. |
| `20220418_RC00` | Minor improvements: fixed potential errors related to SSL certificates during the template launch, and non-critical errors will no longer prevent the Dataflow job from starting. |
| `20220411_RC00` | Security fixes. |
| `20220124_RC00` | Security fixes. |
| `20210419_RC00` | Added telemetry support and fixed a bug related to result file location parsing. |
| `20210120_RC00` | Added support for updating streaming jobs and Flexible Resource Scheduling (FlexRS). |
| `20200803_RC00` | Added support for propagating logs for Docker-related failures. |
| `20200413_RC00` | Initial version of the launcher agent. |

### Python

| Tag | Release note |
|---|---|
| `20261104-RC00` (latest) | Security fixes. Python3.10 is deprecated and will be no longer updated since next release. Python3 base image now uses Python 3.12. |
| `20261026-RC00` | Security fixes and Beam version update. **Note:** This and later versions use `zstd` compression for the upstream Apache Beam Python image, which might cause Cloud Build job failures due to an incompatible Docker Engine version. To avoid this issue, use the latest version of the gcloud CLI (version 591.0.0 or later). |
| `20260901-RC00` | Security fixes. |
| `20260803-RC00` | Security fixes. |
| `20260713_RC01` | Security fixes and Beam version update. |
| `20260603_RC00` | Security fixes and Beam version update. |
| `20260122_RC00` | Security fixes and Beam version update. |
| `20260105_RC00` | Security fixes and Beam version update. As of this version the Python39 container is no longer updated. |
| `20251006_RC00` | Security fixes and Beam version update. |
| `20250923_RC00` | Security fixes. |
| `20250825_RC00` | Security fixes. |
| `20250707_RC00` | Security fixes and Beam version update. |
| `20250514_RC00` | Security fixes. |
| `20250402_RC00` | Security fixes. |
| `20250220_RC00` | Security fixes. |
| `20250124_RC00` | Security fixes. |
| `20241127_RC00` | Security fixes. |
| `20240918_RC00` | Security fixes. Fixed an issue where pipeline options did not support non-ASCII characters. |
| `20240812_RC01` | Security fixes. |
| `20240506_RC00` | Security fixes. |
| `20240325_RC00` | Security fixes. |
| `20230622_RC00` | Security fixes. |
| `20230220_RC00` | Security fixes. |
| `20221018_RC00` | Security fixes. |
| `20220418_RC00` | Minor improvements: fixed potential errors related to SSL certificates during the template launch, and non-critical errors will no longer prevent the Dataflow job from starting. |
| `20220411_RC00` | Security fixes. |
| `20220214_RC00` | Security fixes. |
| `20211101_RC00` | Fixed bug that caused list-type parameters to be treated as a string. |
| `20210419_RC00` | Added telemetry support and fixed a bug related to result file location parsing. |
| `20210120_RC00` | Added support for updating streaming jobs and Flexible Resource Scheduling (FlexRS). |
| `20200803_RC00` | Added support for propagating logs for Docker-related failures. |
| `20200413_RC00` | Initial version of the launcher agent. |

### Go

| Tag | Release note |
|---|---|
| `20261104-RC00` (latest) | Security fixes. |
| `20261026-RC00` | Security fixes and Beam version update. |
| `20261006-RC00` | Security fixes. |
| `20260901-RC00` | Security fixes. |
| `20260803-RC00` | Security fixes. |
| `20260713_RC01` | Security fixes and Beam version update. |
| `20260603_RC00` | Security fixes and Beam version update. |
| `20260122_RC00` | Security fixes and Beam version update. |
| `20260105_RC00` | Security fixes and Beam version update. |
| `20251006_RC00` | Security fixes and Beam version update. |
| `20250923_RC00` | Security fixes. |
| `20250825_RC00` | Security fixes. |
| `20250707_RC00` | Security fixes and Beam version update. |
| `20250514_RC00` | Security fixes. |
| `20250402_RC00` | Security fixes. |
| `20250220_RC00` | Security fixes. |
| `20250124_RC00` | Security fixes. |
| `20241127_RC00` | Security fixes. |
| `20240918_RC00` | Security fixes. Fixed an issue where pipeline options did not support non-ASCII characters. |
| `20240812_RC01` | Security fixes. |
| `20240506_RC00` | Security fixes. |
| `20240325_RC00` | Security fixes. |
| `20230622_RC00` | Security fixes, added Distroless alternative images. |
| `20230220_RC00` | Security fixes. |
| `20220815_RC00` | Initial version of the launcher agent. |


The Flex Template images use the Google-provided base images. For information about
vulnerability scanning and patching, see
[Base images](https://docs.cloud.google.com/software-supply-chain-security/docs/base-images.md.txt).
Depending on the Flex Template image that you choose, the
Dataflow images are either built with Distroless container images or with the Debian operating system. The Dataflow Debian images use Debian 12, also known as Bookworm.


It is recommended that you conduct regular upgrades of your Apache Beam
SDK and template launcher versions to take advantage of the latest patches and
fixes.

<br />