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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Docker are două părți: clientul docker, pe care îl tastezi în terminal, și daemon-ul dockerd, un serviciu care rulează în fundal și chiar pornește containere, descarcă imagini și face build-uri. Clientul îi trimite cererile prin socket-ul unix:///var/run/docker.sock.
Mesajul spune exact asta: clientul a încercat să deschidă socket-ul și nu i-a răspuns nimeni. Întrebarea de la final, Is the docker daemon running?, este și cea mai probabilă cauză: serviciul nu e pornit. Pe Windows și macOS, daemon-ul rulează în Docker Desktop, deci aplicația trebuie să fie deschisă și să fi terminat de pornit. Pe Linux, serviciul docker trebuie să fie activ în systemd.
O verificare rapidă: docker version afișează secțiunea Client mereu, dar secțiunea Server doar când daemon-ul răspunde. Dacă vezi doar clientul și apoi eroarea, problema e la daemon, nu la comanda ta.
De ce apare: cauzele frecvente
1Serviciul Docker nu e pornit (Linux)
docker ps
# Cannot connect to the Docker daemon at unix:///var/run/docker.sock.sudo systemctl start docker
sudo systemctl enable docker # pornește și după restart
docker psPe Linux daemon-ul este un serviciu systemd. După instalare sau după un restart, dacă nu e activat cu enable, nu pornește singur.
2Docker Desktop e închis sau încă pornește
# Docker Desktop închis
docker run hello-world# deschide Docker Desktop și așteaptă „Engine running”
docker info
docker run hello-worldPe Windows și macOS daemon-ul trăiește într-o mașină virtuală pornită de Docker Desktop. Până nu termină de pornit, socket-ul nu răspunde.
3Variabila DOCKER_HOST trimite clientul în altă parte
export DOCKER_HOST=tcp://192.168.1.50:2375
docker psunset DOCKER_HOST
docker context ls
docker psCu DOCKER_HOST setat, clientul nu mai folosește socket-ul local. Dacă adresa e greșită sau serverul e oprit, primești o eroare de conexiune. docker context ls arată ce endpoint folosește clientul.
4Docker rulat în WSL fără integrare
# în Ubuntu din WSL, fără integrare activată
docker ps# Docker Desktop > Settings > Resources > WSL integration
# activează distribuția, apoi într-un terminal nou:
docker psÎn WSL clientul vorbește cu daemon-ul din Docker Desktop doar dacă integrarea e activă pentru distribuția ta.
Repară eroarea, direct în pagină
În terminalul de aici daemon-ul rulează deja, așa că exersezi verificarea pe care o faci după ce repornești serviciul: afișează informațiile serverului cu docker info (sau secțiunea Server din docker version), apoi pornește containerul de test hello-world ca să confirmi că daemon-ul descarcă imagini și pornește containere.
Indiciu
Dacă docker info afișează secțiunea Server, daemon-ul răspunde; docker run hello-world face testul complet.
Reparația
Verifică daemon-ul (secțiunea Server apare doar dacă acesta răspunde):
docker version
docker infoTestul complet, descărcare + pornire de container:
docker run hello-worldLa final vezi mesajul Hello from Docker!. Pe calculatorul tău, dacă primești eroarea, pornește întâi serviciul:
sudo systemctl start dockerDe ce merge
docker info și docker version vorbesc cu daemon-ul prin socket: dacă primești secțiunea Server, conexiunea client–daemon funcționează. docker run hello-world merge mai departe: daemon-ul descarcă imaginea, creează containerul, îl pornește și îți trimite ieșirea lui. Când eroarea Cannot connect to the Docker daemon apare pe calculatorul tău, după ce pornești serviciul (sudo systemctl start docker sau Docker Desktop) aceleași două comenzi îți confirmă că problema a dispărut.
Alte forme ale mesajului
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?error during connect: this error may indicate that the docker daemon is not runningCannot connect to the Docker daemon at unix:///Users/ana/.docker/run/docker.sock. Is the docker daemon running?
Cum o eviți pe viitor
- Pe Linux, activează serviciul o dată:
sudo systemctl enable --now docker. - Pe Windows și macOS, lasă Docker Desktop să pornească la logare (setarea „Start Docker Desktop when you sign in”).
- Începe depanarea cu
docker info: dacă afișează secțiunea Server, daemon-ul e în regulă și problema e în altă parte. - Nu seta
DOCKER_HOSTîn.bashrcdacă nu lucrezi chiar cu un daemon la distanță.
Întrebări frecvente
Merge cu sudo, dar fără sudo primesc altă eroare. E aceeași problemă?
Nu. Dacă daemon-ul răspunde cu sudo, el rulează, iar fără sudo primești de obicei permission denied while trying to connect to the Docker daemon socket: utilizatorul tău nu are drept pe socket. Soluția e să-l adaugi în grupul docker.
Ce fac dacă systemctl start docker eșuează?
Citește motivul cu sudo systemctl status docker și sudo journalctl -u docker -n 50. Cauze tipice: un fișier /etc/docker/daemon.json cu JSON invalid, disc plin sau o instalare incompletă.
Docker Desktop e deschis, dar eroarea rămâne. De ce?
Daemon-ul poate fi încă în pornire sau blocat. Așteaptă mesajul „Engine running”, apoi încearcă din nou; dacă nu apare, folosește „Restart” din meniul Docker Desktop.
Erori înrudite
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). no space left on device Discul pe care Docker își ține datele (/var/lib/docker sau discul virtual al Docker Desktop) e plin. Vezi ce ocupă spațiul cu docker system df, apoi șterge containerele oprite, imaginile nefolosite și cache-ul de build: docker container prune, docker image prune, docker builder prune. docker: Error response from daemon: pull access denied for ngnix, repository does not exist or may require 'docker login': denied: requested access to the resource is denied Docker nu găsește imaginea cerută pe Docker Hub: de obicei numele e scris greșit (ngnix în loc de nginx) sau e o imagine privată ori una locală care nu există încă. Corectează numele sau construiește imaginea înainte, iar pentru cele private rulează docker login. Î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.
