Error response from daemon: client version 1.47 is too new. Maximum supported API version is 1.43
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 șidocker-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
sudo apt-get install --only-upgrade docker-ce-cli
docker pssudo apt-get update
sudo apt-get install --only-upgrade docker-ce docker-ce-cli containerd.io
sudo systemctl restart docker
docker versionClientul și Engine-ul trebuie actualizate împreună; după repornire, daemon-ul acceptă versiunea de API a clientului.
2Daemon vechi pe alt server
export DOCKER_HOST=ssh://ana@server-vechi
docker psexport DOCKER_HOST=ssh://ana@server-vechi
export DOCKER_API_VERSION=1.43
docker psCu DOCKER_API_VERSION, clientul nou vorbește versiunea de API pe care o înțelege serverul vechi.
3Unealtă externă cu client prea nou
# job de CI cu imaginea docker:27-cli
# și daemon-ul Docker 24 al runner-ului
docker build -t app .# 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ă 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.
Reparația
export DOCKER_API_VERSION=1.43
docker versionPe server, reparația definitivă:
sudo apt-get update
sudo apt-get install --only-upgrade docker-ce docker-ce-cli containerd.ioDe ce merge
Clientul folosea implicit API 1.47, pe care daemon-ul vechi nu îl cunoaște. Variabila DOCKER_API_VERSION îi spune clientului să trimită cererile în formatul API 1.43, deci serverul le acceptă. Pentru că e exportată, o primesc toate comenzile docker din sesiune. docker version confirmă: afișează ambele secțiuni, Client și Server. Reparația definitivă rămâne actualizarea Engine-ului pe server.
Alte forme ale mesajului
Error response from daemon: client version 1.41 is too new. Maximum supported API version is 1.40Error response from daemon: client version 1.45 is too new. Maximum supported API version is 1.43Error 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
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running? Comanda docker (clientul) nu găsește serviciul Docker (daemon-ul dockerd) care face de fapt treaba. Pornește Docker Desktop sau serviciul cu sudo systemctl start docker, apoi verifică cu docker info. permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock: Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.47/containers/json": dial unix /var/run/docker.sock: connect: permission denied Daemon-ul rulează, dar utilizatorul tău nu are voie să scrie în socket-ul /var/run/docker.sock. Adaugă-te în grupul docker cu sudo usermod -aG docker $USER, apoi deloghează-te și loghează-te din nou (sau rulează newgrp docker). docker: 'compose' is not a docker command. Clientul docker nu are pluginul Compose v2, deci nu știe subcomanda compose. Instalează pluginul (pe Ubuntu: sudo apt install docker-compose-plugin) sau Docker Desktop. Invers, dacă ai doar v2, docker-compose (cu cratimă) nu există: scrie docker compose, cu spațiu. Î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.
