Kapitel 4 – Troubleshooting Praxis: die 3 Klassiker

Sie lernen die 3 wichtigsten Checks, um Probleme schnell einzugrenzen:

• Läuft der Container?
• Was sagen die Logs?
• Lauschen die Ports?

docker ps --format "table {{.Names}}\t{{.Status}}\t{{.Ports}}"

Interpretation:

• Up → Container läuft
• Restarting → Crash-Loop (Fehler in Logs prüfen)
• Exited → Container beendet (Fehler/Config prüfen)
• In der Spalte PORTS sollte bei n8n etwas wie 0.0.0.0:5678→5678/tcp stehen.

docker logs --tail 80 n8n

Interpretation (typische Hinweise):

• EACCES → Rechteproblem im Persistenz-Ordner
• Mismatching encryption keys → N8N_ENCRYPTION_KEY passt nicht zur gespeicherten config
• Editor is now accessible via → n8n ist erfolgreich gestartet

Optional live mitlaufen lassen:

docker compose logs -f n8n

sudo ss -tulpn | grep -E ':(5678|5679)\b' || true

Interpretation:

• 5678 muss lauschen, damit die Weboberfläche erreichbar ist.
• 5679 ist nur relevant, wenn Task Runner / Python genutzt wird.

• Container „Up“ + Port 5678 lauscht → Browser-Zugriff sollte funktionieren
• Container „Restarting“ → Logs lesen, Ursache beheben
• Port 5678 lauscht nicht → Container läuft nicht oder Port-Mapping fehlt