🛠️ Troubleshooting

Diagnostic checklists and debugging procedures for Docker‑based environments.

---

🚫 Container Not Starting

1. Check container logs

   docker logs <container>
   

2. Inspect container state

   docker inspect <container>
   

3. Verify exposed ports
4. Verify network configuration
5. Check service dependencies (database, API, volumes)

---

🚦 Traefik Cannot See a Container

1. Ensure the container is attached to traefik-net
2. Verify label:

   traefik.enable=true
   

3. Validate router rule (Host(), PathPrefix(), etc.)
4. Confirm backend port:

   traefik.http.services.<name>.loadbalancer.server.port=
   

---

🔐 TLS / Certificate Issues

1. Confirm the domain resolves to the server
2. Ensure tls.certresolver=le is configured
3. Verify port 443 is open
4. Check ACME storage permissions and persistence

---

🧩 Compose Not Starting

# Validate final Compose configuration
docker compose config

# Rebuild and start
docker compose up --build

---

📘 Additional Topics

• Debugging Docker networks
• Troubleshooting Traefik routers
• Diagnosing container crashes
• Fixing ACME / Let's Encrypt errors