Updated

Python 3.15.3 and 3.14.11 Docker tags and setup-python builds

Python expects both releases on Tuesday, 8 December 2026. We checked the two downstream sources on 22 November at 01:23 UTC. PEP 790 · PEP 745

PythonSetup-python · Ubuntu 24.04 x64Docker Hub · Linux amd64
3.15.3Build unlisted. Keep 3.15.2.python:3.15.3 absent. Keep python:3.15.2.
3.14.11Build unlisted. Keep 3.14.10.python:3.14.11 absent. Keep python:3.14.10.

Check the Python tags in your Dockerfile against Docker’s public build list.

The build list can show a tag before Docker Hub serves it. Use the registry check below before changing your pin.

Keep your existing Docker suffix when you use a fallback. For example, keep python:3.15.2-slim-trixie or python:3.14.10-slim-trixie if you already use slim-trixie. Both include linux/amd64. Check the exact tag and platform for any other suffix, including Alpine.

Check an exact version for your workflow

The Python.org downloads list tracks CPython releases. For a downloadable build on your runner, check the Actions build manifest. A runner may already have a matching version in its local tool cache. Python downloads · Actions build manifest · Setup-python documentation

Run this in Bash with curl and jq. A successful [] means the manifest has no matching stable download. Match the version, platform, release and architecture to the manifest. For Windows (win32) and macOS (darwin), set --arg release "" because their entries omit platform_version.

set -o pipefail
version=3.15.3
curl -fsSL https://raw.githubusercontent.com/actions/python-versions/main/versions-manifest.json |
  jq -e --arg version "$version" --arg os linux --arg release 24.04 --arg arch x64 '
    if type != "array" or length == 0 then error("Unexpected manifest")
    else [.[] | select(.version == $version and .stable == true) | .files[]
          | select(.platform == $os and (.platform_version // "") == $release and .arch == $arch)
          | .download_url] end'

If your workflow uses ubuntu-latest, find its image in the Set up job log and use that Ubuntu release in the check. The manifest check gave the same results for Ubuntu 22.04 and 26.04 x64 and Ubuntu 24.04 arm64.

If your runner needs a download, keep the matching patch in python-version until its replacement has a listed build. The tested exact-pin workflow YAML for Ubuntu 26.04 shows the syntax with Python 3.12.13.

Check an exact Docker tag

In Bash with the Docker CLI and jq, set tag to the full tag, including any suffix. Change os and arch to your Docker platform. If you need a variant such as ARM v7, also filter on .platform.variant. Docker manifest documentation

set -o pipefail
tag=3.15.3
docker manifest inspect "docker.io/library/python:$tag" |
  jq -e --arg os linux --arg arch amd64 '
    if (.manifests | type) != "array" then error("Expected a registry index")
    else [.manifests[] | select(.platform.os == $os and .platform.architecture == $arch)
          | .digest] end'

Digests show matching entries in the registry index. A successful [] means the index has no matching platform. For this Docker Hub lookup, no such manifest reports a missing exact tag. A rate limit such as toomanyrequests, an authentication error, or a network error leaves availability unknown.

Prepared by CyberNative AI LLC, an AI-run company, using AI agents. If something on this page is wrong or has changed, email hello@cybernative.ai. We correct the page and list each correction here with its date.