Diese Seite hilft bei der technischen Eingrenzung. Wenn die Website oder der Server produktiv ausgefallen ist, kann ICFOX die Diagnose remote übernehmen.
Docker-Container startet nicht
Ein Container, der sofort stoppt oder ständig neu startet, liefert meist genug Hinweise über Exitcode, Logs und Runtime-Zustand – wenn man sie vor dem nächsten Umbau sichert.
Was der Fehler technisch bedeutet
Docker selbst ist häufig nicht die eigentliche Ursache. Die Anwendung im Container kann wegen fehlender Umgebungsvariablen, nicht erreichbarer Datenbank, falscher Rechte, kaputtem Volume, Port-Konflikt oder OOM abbrechen. Bei Compose-Stacks kommen zusätzlich Abhängigkeiten, Netzwerke und Healthchecks hinzu.
Häufige Ursachen
-
Anwendung beendet sich
EntryPoint oder Prozess crasht wegen Konfiguration, Migration, fehlender Datei oder nicht erreichbarer Abhängigkeit.
-
Volume und Rechte
Bind Mount oder Volume hat falschen Pfad, Eigentümer oder nicht erwarteten Inhalt.
-
Port/Netzwerk-Konflikt
Host-Port ist belegt oder Container erreicht Datenbank/Backend im erwarteten Netzwerk nicht.
-
OOM oder Healthcheck
Container wird wegen Speicher beendet oder gilt trotz laufendem Prozess als unhealthy und wird ersetzt.
Sinnvolle Prüfung in dieser Reihenfolge
-
1. Status und Exitcode sichern
docker ps -a und inspect nutzen, bevor Container entfernt oder neu erstellt wird.
-
2. Logs lesen
docker logs bzw. Compose-Logs nach der ersten Fehlermeldung und dem Startzeitpunkt prüfen.
-
3. Konfiguration vergleichen
Image-Tag, Compose-Datei, env, Secrets, Ports, Volumes und Netzwerke mit dem letzten funktionierenden Stand abgleichen.
-
4. Abhängigkeiten prüfen
Datenbank, Redis, DNS, Zertifikate, Healthchecks und Migrationsschritte separat testen.
Was Sie jetzt besser nicht tun
Nicht sofort `docker compose down -v` ausführen: `-v` kann benannte Volumes löschen. Auch `docker system prune` ist keine Reparaturstrategie für einen unbekannten Produktionsfehler. Erst Daten und Ursache sichern.
Verwandte Fehler und direkte Hilfe
Wenn die Ursache nicht schnell eindeutig wird, führen die folgenden Seiten zur passenden Soforthilfe oder zu einem eng verwandten Fehlerbild.
Häufige Fragen
Was bedeutet Exitcode 137?
Häufig wurde der Prozess mit SIGKILL beendet; OOM ist eine typische Ursache, muss aber über Host- und Containerdaten bestätigt werden.
Warum läuft der Container manuell, aber nicht in Compose?
Compose kann andere Umgebungsvariablen, Netzwerke, Volumes, Healthchecks oder Startreihenfolgen verwenden.
Soll ich den Container einfach neu bauen?
Nur wenn klar ist, dass Image oder Build die Ursache sind. Ein Rebuild behebt keine falschen Secrets, Datenbankprobleme oder kaputten Volumes.