🟠 High   ⏱ 5–30 min  Last verified: 19 May 2026
Affected versions: Ubuntu 24.04 LTS

πŸ“– ~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 workloads stop because dockerd fails to initialize.

Environment & Reproduction

Appears after manual edits to /etc/docker/daemon.json.

sudo systemctl restart docker
sudo systemctl status docker
docker ps

Root Cause Analysis

Invalid JSON or unsupported keys cause daemon startup failure.

Quick Triage

Validate JSON and inspect recent daemon logs.

sudo cat /etc/docker/daemon.json
sudo journalctl -u docker -n 100
dockerd --validate --config-file /etc/docker/daemon.json

Step-by-Step Diagnosis

Pinpoint malformed fields and compare against documented options.

python3 -m json.tool /etc/docker/daemon.json
dockerd --help | head -n 40
sudo systemctl cat docker
Illustrative mockup for ubuntu-24-04-lts β€” terminal_or_shell
Docker daemon configuration validation β€” Illustrative mockup β€” Progressive Robot

Solution – Primary Fix

Correct daemon.json and restart Docker cleanly.

Still having issues? Our IT Solutions & Services team can diagnose and resolve this for you. Get in touch for a free consultation.

sudo cp /etc/docker/daemon.json /etc/docker/daemon.json.bak
sudoedit /etc/docker/daemon.json
sudo systemctl daemon-reload
sudo systemctl restart docker
Illustrative mockup for ubuntu-24-04-lts β€” logs_or_journal
dockerd startup failure logs β€” Illustrative mockup β€” Progressive Robot

Solution – Alternative Approaches

Temporarily move daemon.json aside to run defaults.

sudo mv /etc/docker/daemon.json /etc/docker/daemon.json.disabled
sudo systemctl restart docker

Verification & Acceptance Criteria

Docker is active and containers can launch.

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

Rollback Plan

Restore known-good daemon config from backup.

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

Prevention & Hardening

Validate JSON changes in staging before production rollout.

python3 -m json.tool /etc/docker/daemon.json
sudo systemctl status docker

Related to cgroup, storage driver, and proxy configuration issues.

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 Docker Engine configuration documentation.

Need Expert Help?

If you cannot resolve this yourself, our team offers hands-on Server Management, Managed IT Services, and flexible Support Plans. Contact us today β€” we respond within one business day.