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

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

Pe scurt

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

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

Ce înseamnă

Spre deosebire de Cannot connect to the Docker daemon, aici daemon-ul există și ascultă. Problema e de permisiuni Linux: socket-ul /var/run/docker.sock aparține utilizatorului root și grupului docker (srw-rw---- root docker), deci doar root și membrii grupului docker îl pot folosi.

Partea Get "http://%2Fvar%2Frun%2Fdocker.sock/v1.47/containers/json" arată cererea pe care clientul voia s-o trimită (aici, lista de containere de la docker ps), iar finalul connect: permission denied spune că sistemul de operare a refuzat deschiderea socket-ului.

Apare aproape mereu imediat după instalarea Docker pe Linux, înainte să-ți adaugi utilizatorul în grup, sau după ce l-ai adăugat dar n-ai deschis o sesiune nouă: grupurile se citesc doar la logare. Verifică cu groups: dacă docker lipsește din listă, ai găsit cauza.

De ce apare: cauzele frecvente

1Utilizatorul nu e în grupul docker

Greșit
BASH
groups
# ana adm sudo
docker ps
Corect
BASH
sudo usermod -aG docker $USER
# deloghează-te și loghează-te din nou
groups
# ana adm sudo docker
docker ps

Doar root și membrii grupului docker pot folosi socket-ul. După usermod, grupul nou intră în vigoare abia într-o sesiune nouă.

2Te-ai adăugat în grup, dar sesiunea e veche

Greșit
BASH
sudo usermod -aG docker $USER
docker ps   # tot permission denied
Corect
BASH
newgrp docker
docker ps

Shell-ul curent are lista de grupuri de la logare. newgrp docker deschide un shell cu grupul nou fără să te deloghezi.

3Folosești sudo la fiecare comandă ca ocolire

Greșit
BASH
sudo docker run -v ~/date:/date alpine touch /date/a.txt
Corect
BASH
sudo usermod -aG docker $USER   # o singură dată
docker run -v ~/date:/date alpine touch /date/a.txt

Cu sudo, ~ și variabilele pot fi ale lui root, iar fișierele create ajung cu proprietarul root. Grupul docker rezolvă cauza, nu simptomul.

Repară tu

Repară eroarea, direct în pagină

În terminalul de aici utilizatorul elev este deja în grupul docker, ca după reparația corectă. Verifică asta cu groups (sau id), apoi rulează fără sudo un container numit test-acces din imaginea alpine care afișează acces ok și se termină.

Indiciu

groups trebuie să conțină docker; containerul îl pornești cu docker run --name test-acces alpine echo "acces ok".

Alte forme ale mesajului

  • Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sock
  • permission denied while trying to connect to the docker API at unix:///var/run/docker.sock

Cum o eviți pe viitor

După instalarea Docker pe Linux, fă imediat pașii de după instalare din documentația oficială: sudo groupadd docker (de obicei există deja), sudo usermod -aG docker $USER, apoi deloghează-te și verifică cu groups și docker run hello-world. Nu face chmod 666 /var/run/docker.sock: dă acces la daemon oricui de pe calculator și se pierde oricum la repornirea serviciului. Ține minte că grupul docker înseamnă practic drepturi de root, deci adaugă în el doar utilizatorii în care ai încredere.

Întrebări frecvente

E sigur să-mi adaug utilizatorul în grupul docker?

Pe calculatorul tău de dezvoltare, da, e configurarea recomandată. Ține minte însă că cine poate porni containere poate monta orice folder al sistemului, deci grupul docker e echivalent cu acces de root. Pe servere partajate, alternativa e Docker în modul rootless.

De ce merge cu sudo, dar nu fără?

Pentru că sudo rulează comanda ca root, iar root are acces la socket. Fără sudo, rulezi ca utilizatorul tău, care nu e (încă) în grupul docker.

Pe macOS sau Windows pot primi eroarea asta?

Rar. Docker Desktop configurează singur accesul; o vezi în special pe Linux, în WSL sau într-un container care montează /var/run/docker.sock și rulează cu alt utilizator.

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.