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

Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?

Pe scurt

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)

Greșit
BASH
docker ps
# Cannot connect to the Docker daemon at unix:///var/run/docker.sock.
Corect
BASH
sudo systemctl start docker
sudo systemctl enable docker   # pornește și după restart
docker ps

Pe 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

Greșit
BASH
# Docker Desktop închis
docker run hello-world
Corect
BASH
# deschide Docker Desktop și așteaptă „Engine running”
docker info
docker run hello-world

Pe 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

Greșit
BASH
export DOCKER_HOST=tcp://192.168.1.50:2375
docker ps
Corect
BASH
unset DOCKER_HOST
docker context ls
docker ps

Cu 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

Greșit
BASH
# în Ubuntu din WSL, fără integrare activată
docker ps
Corect
BASH
# 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ă tu

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.

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 running
  • Cannot 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 .bashrc dacă 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

← 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.