Table of Contents

Service Not Starting

Container fails to start or restarts repeatedly.

Symptom

`docker compose ps` shows containers with `Exited` status. Services not accessible.

Cause

Multiple possible causes including configuration errors, port conflicts, or resource issues.

Fix

Steps:

1. Check logs: `docker compose logs service_name`
2. Check configuration: `docker compose config`
3. Verify no port conflicts: `netstat -tulpn | grep PORT`
4. Check disk space: `df -h`

Prevention

Test configuration changes locally before deploying. Monitor disk space regularly.

See Also

Last updated: 2026-06-19