So sieht die Meldung aus
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 deniedHäufige Ursachen
- Dein Benutzer ist nicht in der Gruppe
docker. - Du wurdest zur Gruppe hinzugefügt, deine aktuelle Sitzung kennt aber noch die alte Gruppenliste.
- Die Rechte von
/var/run/docker.sockwurden geändert. - Ein Skript oder CI-Job läuft unter einem anderen Benutzer als dem, mit dem du getestet hast.
- Bei Rootless Docker zeigt der Client auf den falschen Socket.
Prüfen
- Welche Gruppen hat deine Sitzung?
id - Wem gehört der Socket?
ls -l /var/run/docker.sock - Läuft der Daemon überhaupt?
systemctl status docker
Lösung
- Den Benutzer zur Gruppe hinzufügen:
sudo usermod -aG docker $USER. - Ab- und wieder anmelden oder eine Shell mit der neuen Gruppe starten:
newgrp docker. - Für einen schnellen Einzelfall den Befehl mit
sudoausführen. - Bei CI oder Diensten den Dienstbenutzer zur Gruppe hinzufügen und den Dienst neu starten.
- Rootless Docker oder Podman bevorzugen, wenn du keine root-gleichen Rechte vergeben willst.
Typisches Szenario
Auf einem frischen Ubuntu-VPS hast du Docker mit dem Installationsskript eingerichtet und arbeitest als Benutzer deploy. docker ps endet mit „permission denied … docker.sock“, mit sudo geht es. Das ist Absicht: Die Installation gibt den Socket nur root und der Gruppe docker frei. Prüfe mit id und ls -l /var/run/docker.sock, ob dein Benutzer in der Gruppe ist und der Socket der Gruppe docker gehört.
Häufige Fragen
Ist es sicher, einen Benutzer zur Gruppe docker hinzuzufügen?
Es entspricht root-Rechten auf dem Host, weil ein Container beliebige Verzeichnisse einbinden kann. Nur für Personen tun, denen du Admin-Rechte zutraust.
Und wenn die Meldung sagt, dass gar keine Verbindung zum Daemon möglich ist?
Das ist ein anderer Fehler: Der Docker-Dienst läuft nicht. Mit systemctl start docker starten und bei Misserfolg das Journal lesen.
Warum geht docker mit sudo, aber der Runner in meiner CI nicht?
Der Runner läuft meist als eigener Dienstbenutzer mit eigener Gruppenliste. Füge genau diesen Benutzer der Gruppe docker hinzu und starte den Dienst neu, denn laufende Prozesse behalten ihre alten Gruppen. Dein eigener Login ist dafür irrelevant.
Soll ich den Socket mit chmod 666 öffnen?
Nein. Dann könnte jeder lokale Benutzer Container starten und damit praktisch Root-Rechte erlangen. Außerdem legt der Docker-Dienst den Socket beim Neustart wieder mit den Standardrechten an, die Änderung wäre also ohnehin nicht dauerhaft.
Woran sehe ich, welche Gruppen meine aktuelle Shell wirklich hat?
id zeigt die Gruppen der laufenden Sitzung, id deploy die in der Systemdatenbank eingetragenen. Fehlt docker nur beim ersten Befehl, hast du dich nach dem usermod noch nicht neu angemeldet. Fehlt sie bei beiden, wurde der Benutzer nicht hinzugefügt.