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).
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
groups
# ana adm sudo
docker pssudo usermod -aG docker $USER
# deloghează-te și loghează-te din nou
groups
# ana adm sudo docker
docker psDoar 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
sudo usermod -aG docker $USER
docker ps # tot permission deniednewgrp docker
docker psShell-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
sudo docker run -v ~/date:/date alpine touch /date/a.txtsudo usermod -aG docker $USER # o singură dată
docker run -v ~/date:/date alpine touch /date/a.txtCu sudo, ~ și variabilele pot fi ale lui root, iar fișierele create ajung cu proprietarul root. Grupul docker rezolvă cauza, nu simptomul.
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".
Reparația
Verifică grupurile:
groupsLista conține docker, deci socket-ul e accesibil. Testul, fără sudo:
docker run --name test-acces alpine echo "acces ok"acces okPe calculatorul tău, dacă docker lipsește din groups:
sudo usermod -aG docker $USER
newgrp dockerDe ce merge
Socket-ul daemon-ului poate fi folosit de root și de membrii grupului docker. Când groups arată docker, clientul are voie să deschidă /var/run/docker.sock, deci orice comandă docker merge fără sudo. Pe calculatorul tău ajungi în starea asta cu sudo usermod -aG docker $USER urmat de o sesiune nouă (delogare sau newgrp docker); containerul de test confirmă că accesul funcționează cap-coadă.
Alte forme ale mesajului
Got permission denied while trying to connect to the Docker daemon socket at unix:///var/run/docker.sockpermission 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
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. sh: can't create /usr/share/nginx/html/nou.html: Read-only file system Folderul în care scrii e montat doar pentru citire: un bind mount sau volum cu :ro, --mount ...,readonly sau un container pornit cu --read-only. Scrie fișierul pe calculator, în folderul montat (modificarea apare imediat în container), sau montează fără :ro dacă scrierea din container chiar e necesară. docker: Error response from daemon: unable to find user app: no matching entries in passwd file. Utilizatorul dat la -u sau la USER în Dockerfile nu există în /etc/passwd al imaginii. Creează-l în Dockerfile (RUN addgroup -S app && adduser -S -G app app) înainte de USER, sau folosește un utilizator existent (node, nobody) ori un uid numeric. Î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.
