Ubuntu 22.04 Docker permission denied for non-root user

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Users on Ubuntu 22.04 may see permission denied when running docker commands without sudo.

Environment & Reproduction

docker ps fails with cannot connect to Docker daemon socket permission errors.

Root Cause Analysis

User is not in docker group, daemon not running, or socket ownership is incorrect.

Quick Triage

Confirm Docker service status and test command behavior with sudo for comparison.

Step-by-Step Diagnosis

Run id, getent group docker, ls -l /var/run/docker.sock, and systemctl status docker.

Solution – Primary Fix

Add the user to docker group, re-login session, then verify docker info works without sudo.

Solution – Alternative Approaches

Run docker run hello-world and confirm expected container execution as non-root.

Verification & Acceptance Criteria

Use role-based access and limit docker group membership to trusted administrators.

Rollback Plan

Docker group grants elevated control of the host; treat membership as privileged access.

Prevention & Hardening

Ensure overlay2 storage driver and sufficient disk IOPS for consistent container performance.

Related Errors & Cross-Refs

Remove user from docker group with gpasswd -d if access should be revoked.

Related tutorial: View the step-by-step tutorial for Ubuntu 22.04 LTS.

View all Ubuntu 22.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Use Docker Engine for Ubuntu documentation and systemd service references.