====== 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 =====

  * [[folkzone:troubleshooting:start|Troubleshooting Index]]
  * [[folkzone:infrastructure:docker|Docker Infrastructure]]

Last updated: 2026-06-19
  * [[folkzone:start|Return to folkzone]]