...
Eroare Docker · Daemon-ul Docker și permisiuni

Error response from daemon: client version 1.47 is too new. Maximum supported API version is 1.43

Pe scurt

Clientul docker e mai nou decât daemon-ul și cere o versiune de API pe care serverul nu o cunoaște. Actualizează Docker Engine (sau Docker Desktop) pe server, ori, temporar, spune-i clientului ce versiune să folosească: export DOCKER_API_VERSION=1.43.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Comanda docker are două părți: clientul (CLI-ul pe care îl rulezi) și daemon-ul (dockerd), care chiar pornește containerele. Ele vorbesc printr-un API cu versiuni numerotate. Clientul Docker 27 vorbește implicit API 1.47, iar un daemon Docker 24 știe cel mult API 1.43. Mesajul îți spune exact asta: client version 1.47 is too new, iar serverul acceptă maximum 1.43.

Apare des când:

  • ai actualizat doar pachetul docker-ce-cli, nu și docker-ce;
  • te conectezi la un daemon de pe alt server (DOCKER_HOST=ssh://... sau un context Docker) care are o versiune mai veche;
  • folosești un client descărcat separat (binarul static, un plugin, o unealtă de CI) lângă un Engine vechi.

docker version îți arată ambele părți: secțiunea Client cu API version și secțiunea Server cu API version și minimum version. Diferența dintre ele e cauza.

De ce apare: cauzele frecvente

1Doar clientul a fost actualizat

Greșit
BASH
sudo apt-get install --only-upgrade docker-ce-cli
docker ps
Corect
BASH
sudo apt-get update
sudo apt-get install --only-upgrade docker-ce docker-ce-cli containerd.io
sudo systemctl restart docker
docker version

Clientul și Engine-ul trebuie actualizate împreună; după repornire, daemon-ul acceptă versiunea de API a clientului.

2Daemon vechi pe alt server

Greșit
BASH
export DOCKER_HOST=ssh://ana@server-vechi
docker ps
Corect
BASH
export DOCKER_HOST=ssh://ana@server-vechi
export DOCKER_API_VERSION=1.43
docker ps

Cu DOCKER_API_VERSION, clientul nou vorbește versiunea de API pe care o înțelege serverul vechi.

3Unealtă externă cu client prea nou

Greșit
BASH
# job de CI cu imaginea docker:27-cli
# și daemon-ul Docker 24 al runner-ului
docker build -t app .
Corect
BASH
# aliniază versiunile sau fixează API-ul în job
export DOCKER_API_VERSION=1.43
docker build -t app .

Imaginea docker:27-cli aduce clientul nou; daemon-ul runner-ului rămâne la versiunea lui până îl actualizezi.

Repară tu

Repară eroarea, direct în pagină

Te conectezi la un server cu Docker Engine 24, iar clientul tău nou primește client version 1.47 is too new. Maximum supported API version is 1.43. Până se actualizează serverul, setează pentru sesiunea curentă versiunea de API acceptată de server (variabila exportată DOCKER_API_VERSION=1.43), apoi verifică legătura cu docker version.

Indiciu

export DOCKER_API_VERSION=1.43, apoi docker version.

Alte forme ale mesajului

  • Error response from daemon: client version 1.41 is too new. Maximum supported API version is 1.40
  • Error response from daemon: client version 1.45 is too new. Maximum supported API version is 1.43
  • Error response from daemon: client version 1.24 is too old. Minimum supported API version is 1.25, please upgrade your client to a newer version

Cum o eviți pe viitor

Actualizează Docker ca pe un tot: docker-ce, docker-ce-cli, containerd.io și pluginurile (docker-compose-plugin, docker-buildx-plugin) din același depozit. După orice actualizare, rulează docker version și verifică că secțiunile Client și Server au aceeași versiune majoră. Pe serverele vechi pe care nu le poți actualiza, setează DOCKER_API_VERSION doar în contextul sau scriptul care vorbește cu ele, nu global.

Întrebări frecvente

Pot lăsa DOCKER_API_VERSION setat permanent?

Poți, dar e o soluție de avarie: clientul pierde funcțiile apărute în versiunile noi de API. Reparația adevărată e să actualizezi daemon-ul la aceeași versiune cu clientul.

Ce înseamnă varianta „is too old”?

Situația inversă: clientul e prea vechi față de daemon. Actualizează clientul (docker-ce-cli) sau unealta care îl include.

Erori înrudite

← Toate erorile Docker

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Docker de la zero, cu exerciții la fiecare lecție

Curs Docker: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.