Ubuntu 24.04 LTS – Docker service fails after cgroup configuration mismatch

📖 ~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 daemon does not start, stopping container workloads.

Environment & Reproduction

Common after daemon.json edits or runtime updates.

sudo systemctl status docker --no-pager

Root Cause Analysis

Configured cgroup driver conflicts with systemd/cgroupv2 environment.

Quick Triage

Review daemon logs and cgroup mode on host.

stat -fc %T /sys/fs/cgroup
sudo journalctl -u docker -n 120 --no-pager

Step-by-Step Diagnosis

Inspect daemon config and runtime settings.

sudo cat /etc/docker/daemon.json
docker info 2>/dev/null | grep -i cgroup || true

Solution – Primary Fix

Set matching cgroup driver in daemon config and restart Docker.

sudo mkdir -p /etc/docker
echo '{"exec-opts": ["native.cgroupdriver=systemd"]}' | sudo tee /etc/docker/daemon.json
sudo systemctl restart docker

Solution – Alternative Approaches

Reinstall Docker engine packages if daemon binaries/config are inconsistent.

sudo apt-get install --reinstall -y docker-ce docker-ce-cli containerd.io

Verification & Acceptance Criteria

Docker daemon is active and can run a test container.

systemctl is-active docker
sudo docker run --rm hello-world

Rollback Plan

Restore prior daemon.json and restart service if runtime behavior regresses.

sudo cp /etc/docker/daemon.json.bak /etc/docker/daemon.json
sudo systemctl restart docker

Prevention & Hardening

Standardize daemon configuration with config management and preflight checks.

sudo dockerd --validate --config-file=/etc/docker/daemon.json

Related Errors & Cross-Refs

Related to failed to start daemon and cgroup driver mismatch errors.

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

View all Ubuntu 24.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu container runtime and Docker cgroup guidance.