Ubuntu 22.04 LTS Docker Permission Denied on /var/run/docker.sock

📖 ~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

Docker commands fail for non-root users, blocking container workflows and CI jobs.

Environment & Reproduction

Typical on Ubuntu 22.04 LTS after fresh Docker Engine setup.

Root Cause Analysis

User account lacks membership in docker group that controls access to docker.sock.

Quick Triage

Check docker.sock owner/group and current user group list.

Step-by-Step Diagnosis

Verify docker daemon status and confirm socket permissions are correct.

Solution – Primary Fix

Add user to docker group and re-login so group token applies.

Solution – Alternative Approaches

Use rootless Docker mode for tighter privilege boundaries in shared environments.

Verification & Acceptance Criteria

Non-root docker ps works and container lifecycle commands succeed consistently.

Rollback Plan

Remove user from docker group if security policy requires root-only daemon access.

Prevention & Hardening

Review docker group privilege implications and apply least-privilege team policies.

Related Errors & Cross-Refs

Connected with daemon not running and cgroup driver mismatch issues.

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

See Docker on Ubuntu docs and Docker post-installation best practices.