recomended buildx / docker engine version ?

[abate]

Is there a recommended schema to upgrade buildx and docker engine together ?
At the moment I'm using

# Docker Buildx
# https://github.com/docker/buildx
ARG DOCKER_VERSION
FROM docker/buildx-bin:0.12.0 AS buildx

# Docker Alpine 3.16 based image
# https://hub.docker.com/_/docker
ARG DOCKER_VERSION
# hadolint ignore=DL3006
FROM docker:${DOCKER_VERSION} AS base

where DOCKER_VERSION=24.0.7

everything is working fine. I'm wondering if I upgrade the docker engine what is the mix/max recommended version for each docker engine release.

Is this information available ? Should I always use the latest tag for buildx ? what is the compatibility matrix ?

thank you !!!

[disdorqin]

Hi — I think what you're seeing is less a single "compatibility matrix" and more the interaction between three independent things: the Buildx CLI plugin version, the Docker Engine version it talks to, and which builder driver is currently active.

A few read-only checks will show what's actually in play:

docker version
docker buildx version
docker buildx ls
docker context ls

The docker driver and the docker-container driver (and any remote builder) don't all expose the same features, so the same Buildx binary can behave differently depending on the active builder. According to the official Buildx README, Buildx requires Docker Engine 19.03 or newer, and mixing an incompatible Engine with a newer BuildKit-backed builder can cause unexpected behavior — but there isn't a published per-version matrix.

If you share the output of the four commands above (especially the Engine and Buildx versions and the driver listed by docker buildx ls), I can point to the most relevant upgrade path for your setup. Always pinning both versions explicitly, as you already do in the Dockerfile, is a sound practice.