How to fix Error response from daemon: client version X.XX is too old. Minimum supported API version is X.XX in Docker

What this error means

When Docker commands are executed, the Docker client communicates with the Docker daemon through a REST API. Both the client and daemon support specific API versions, and version negotiation occurs automatically to find a compatible version they can both speak. The "client version is too old" error indicates that your Docker client is trying to use an API version that the Docker daemon no longer supports. This became a widespread issue with Docker Engine 29.0.0 (released in 2025), which raised the minimum supported API version from v1.24 to v1.44, effectively requiring Docker clients to be version 25.0 or newer. This error commonly affects: - **CI/CD pipelines** using older Docker-in-Docker images or Docker clients - **Third-party tools** like Traefik, Portainer, or Testcontainers that use older Docker SDKs - **Remote Docker setups** where the client and server versions are mismatched - **Development environments** after a Docker daemon upgrade without upgrading the client The mismatch can occur in either direction - a client that's too old for the server, or less commonly, a server that's too old for the client.

Typical symptoms

• Docker commands fail with 'Error response from daemon: client version X.XX is too old'
• Error mentions 'Minimum supported API version is 1.44' (or another version)
• CI/CD pipelines fail after Docker engine auto-update
• Traefik, Portainer, or other container management tools stop discovering containers
• docker-compose or docker compose commands fail with API version errors
• Testcontainers tests fail with API compatibility errors
• Docker SDK-based applications stop working after daemon upgrade
• Remote Docker connections from older clients fail

Common causes

1. Docker Engine upgraded to version 29.0+ which requires API v1.44 minimum (most common)
2. Docker-in-Docker (DIND) image auto-updated to 29.x while client remains on older version
3. Third-party tools using older Docker SDK versions incompatible with new daemon
4. Client and server Docker versions significantly mismatched
5. CI/CD runner using floating Docker image tags that auto-updated
6. DOCKER_API_VERSION environment variable set to an unsupported version
7. Using an outdated Docker client binary with a newer daemon
8. Container orchestration tools not updated after daemon upgrade

How to fix "Error response from daemon: client version X.XX is too old. Minimum supported API version is X.XX"

docker version

Client:
 Version:           24.0.7
 API version:       1.43
 ...

Server:
 Engine:
  Version:          29.0.0
  API version:      1.48 (minimum version 1.44)
  ...

docker --version
which docker

# Update package list and upgrade Docker
sudo apt-get update
sudo apt-get install --only-upgrade docker-ce docker-ce-cli containerd.io

# Verify the upgrade
docker version

sudo dnf upgrade docker-ce docker-ce-cli containerd.io
# or
sudo yum upgrade docker-ce docker-ce-cli containerd.io

# GitLab CI example - pin to a compatible version
image: docker:29.0
services:
  - docker:29.0-dind

# Create or edit daemon.json
sudo nano /etc/docker/daemon.json

{
  "min-api-version": "1.24"
}

sudo systemctl restart docker

docker version
# Should show: API version: 1.48 (minimum version 1.24)

sudo mkdir -p /etc/systemd/system/docker.service.d
sudo tee /etc/systemd/system/docker.service.d/min-api-version.conf << 'EOF'
[Service]
Environment="DOCKER_MIN_API_VERSION=1.24"
EOF

sudo systemctl daemon-reload
sudo systemctl restart docker

DOCKER_API_VERSION=1.44 docker ps
DOCKER_API_VERSION=1.44 docker-compose up

export DOCKER_API_VERSION=1.44
docker ps  # Now uses API 1.44

variables:
  DOCKER_API_VERSION: "1.44"

build:
  script:
    - docker build -t myapp .

services:
  myservice:
    environment:
      - DOCKER_API_VERSION=1.44

# List available versions
apt-cache madison docker-ce

# Downgrade to a specific version (e.g., 28.0.4)
sudo apt-get install docker-ce=5:28.0.4-1~ubuntu.22.04~jammy docker-ce-cli=5:28.0.4-1~ubuntu.22.04~jammy

# Hold the version to prevent auto-upgrade
sudo apt-mark hold docker-ce docker-ce-cli

# List available versions
yum list docker-ce --showduplicates

# Downgrade
sudo yum downgrade docker-ce-28.0.4 docker-ce-cli-28.0.4

# Hold the version
sudo yum versionlock docker-ce docker-ce-cli

services:
  - docker:28.0.4-dind

# docker-compose.yml for Traefik
services:
  traefik:
    image: traefik:v3.3.6  # or newer

docker pull portainer/portainer-ce:latest
# Restart your Portainer container

<!-- Maven -->
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>testcontainers</artifactId>
    <version>1.21.0</version> <!-- Use latest -->
</dependency>

// Gradle
testImplementation 'org.testcontainers:testcontainers:1.21.0'

# Check versions
docker version

# Test basic operations
docker ps
docker images
docker pull hello-world
docker run --rm hello-world

# Check daemon configuration
docker info | grep -i "api version"

which -a docker
type docker

Advanced notes

# SSH connection to remote Docker
export DOCKER_HOST=ssh://user@remote-host
docker version  # May show version mismatch

# List contexts
docker context ls

# Check version for a specific context
docker --context my-remote-server version

# Check buildx version
docker buildx version

# Update buildx
docker buildx install

# Script to check versions across hosts
for host in host1 host2 host3; do
  echo "=== $host ==="
  ssh $host "docker version --format '{{.Server.Version}} API:{{.Server.APIVersion}}'"
done

Frequently asked questions

What does "Error response from daemon: client version X.XX is too old. Minimum su" mean?

When Docker commands are executed, the Docker client communicates with the Docker daemon through a REST API. Both the client and daemon support specific API versions, and version negotiation occurs automatically to find a compatible version they can both speak. The "client version is too old" error indicates that your Docker client is trying to use an API version that the Docker daemon no longer supports.

How do I fix "Error response from daemon: client version X.XX is too old. Minimum su"?

This error occurs when your Docker client uses an older API version than the minimum supported by the Docker daemon. Common after Docker Engine 29.0 upgrade which raised the minimum API to v1.44. Fix by updating the client, lowering daemon's minimum API, or using DOCKER_API_VERSION.

What causes "Error response from daemon: client version X.XX is too old. Minimum su"?

Docker Engine upgraded to version 29.0+ which requires API v1.44 minimum (most common) Docker-in-Docker (DIND) image auto-updated to 29.x while client remains on older version Third-party tools using older Docker SDK versions incompatible with new daemon

Is the "Error response from daemon: client version X.XX is too old. Minimum su" error serious?

It is a medium-severity error — more of a blocker than a risk. The steps above resolve it.

Related errors

• Error response from daemon: client version X.XX is too new. Maximum supported API version is X.XX

  How to fix 'client version is too new' in Docker

  MEDIUM

• Error starting userland proxy: listen tcp4 0.0.0.0:3000: bind: address already in use

  How to fix "address already in use" in Docker

  MEDIUM

• ERROR: unable to select packages: pkg (no such package)

  How to fix 'unable to select packages: no such package' in Alpine Docker

  MEDIUM

• ADD failed: file not found in build context or excluded by .dockerignore

  How to fix 'ADD failed: file not found in build context' in Docker

  MEDIUM

• WSL 2 requires an update to its kernel component

  How to fix 'WSL 2 requires an update to its kernel component' in Docker

  MEDIUM

• dial tcp: i/o timeout

  How to fix 'dial tcp: i/o timeout' in Docker

  MEDIUM

Official resources & further reading

• 📚Docker Official Documentation
• 📖
  Docker Engine API - Official Documentation(Official Docs)
• 📖
  Engine API Version History - Docker Docs(Official Docs)
• 📖
  Docker Engine 29 Release Notes(Official Docs)
• 📖
  docker version CLI Reference - Docker Docs(Official Docs)
• 📝
  Docker Engine v29 Release - Docker Blog
• 💬
  Sudden Docker error about client API version - Stack Overflow(Stack Overflow)
• 💬
  Error response from daemon: client version is too new - Stack Overflow(Stack Overflow)
• 🐙
  Error response from daemon: client version 1.24 is too old - Traefik GitHub(GitHub)
• 🔗
  Client version is too old error in Docker - GitLab Support
• 🔗
  Docker 29 increased minimum API version - Docker Community Forums