So stimmen Sie Docker-Neustartrichtlinien auf Datenbanken, Worker und Web-Apps ab

Eva Wong ist die technische Redakteurin und begeisterte Tüftlerin bei ZimaSpace. Als lebenslanger Geek mit einer Leidenschaft für Homelabs und Open-Source-Softwarehat sie sich darauf spezialisiert, komplexe technische Konzepte in verständliche, praxisnahe Anleitungenzu übersetzen. Eva ist überzeugt, dass Self-Hosting Spaß machen sollte und nicht einschüchternd sein darf. Mit ihren Tutorials hilft sie der Community dabei, Hardware-Setups zu durchschauen, vom Bau des ersten NAS bis zum sicheren Umgang mit Docker-Containern.

Docker-Neustartrichtlinien sollten zum Lebenszyklus und Beendigungsverhalten des Dienstes passen, statt in einer Compose-Datei jedem Container unless-stopped zuzuweisen.

Neustartrichtlinien greifen, wenn der Hauptprozess eines Containers beendet wird; ein Health-Check kann einen weiterhin laufenden Prozess als fehlerhaft markieren, ohne ihn automatisch neu zu starten. Für Datenbanken, Worker, Webanwendungen, Migrationen und geplante Jobs sind daher unterschiedliche Einstellungen nötig, je nachdem, ob sie dauerhaft laufen sollen, was ein reguläres Beenden bedeutet und wie wiederholte Fehler gemeldet werden sollen.

Neustartverhalten von Health-Checks und Bereitschaft trennen

Eine Neustartrichtlinie legt fest, ob Docker einen Container erneut starten soll, nachdem dessen Prozess beendet wurde. Ein Health-Check prüft, ob der laufende Dienst einen festgelegten Vorgang ausführen kann. Die Bereitschaft von Abhängigkeiten bestimmt, ob ein anderer Dienst bereits starten sollte. Diese Funktionen lösen ähnliche, aber unterschiedliche Probleme.

Ein Artikel aus dem Jahr 2026 zu Health-Checks und Neustarts als getrennte Funktionen erläutert diese Trennung und zeigt, wie Health-Bedingungen in Compose den Start abhängiger Dienste verzögern können, bis ein Dienst tatsächlich bereit ist.

Erwarte nicht, dass restart: always einen fehlerhaften Webprozess repariert, der nie beendet wird, und erwarte auch nicht, dass ein Health-Check allein ihn neu startet. Lass die Anwendung den Prozess beenden, wenn ein sicherer Betrieb nicht mehr möglich ist, füge einen externen Wiederherstellungsmechanismus hinzu oder richte je nach Servicedesign einen Alarm für den fehlerhaften Zustand ein.

Für dauerhaft laufende Datenbanken persistente Neustartrichtlinien verwenden

Von einer Datenbank auf einem Home-Server wird normalerweise erwartet, dass sie nach einem Neustart des Hosts oder Docker-Daemons wieder startet. unless-stopped ist oft eine praktische Standardeinstellung, wenn ein beabsichtigtes manuelles Stoppen durch einen Administrator berücksichtigt werden soll; always eignet sich, wenn ein Neustart dieses manuelle Stoppen absichtlich außer Kraft setzen soll.

Ein Artikel vom Juli 2026 zu Neustartrichtlinien in Abhängigkeit vom Prozessende erläutert die Unterschiede zwischen no, on-failure, always und unless-stopped. Er stellt außerdem klar, dass die Richtlinie auf das Prozessende und nicht auf den Health-Status reagiert.

Auch die Datenbank braucht einen echten Health-Check und dauerhaften Speicher. PostgreSQL immer wieder neu zu starten, behebt weder eine volle Festplatte noch eine ungültige Konfiguration, einen beschädigten Zustand oder eine inkompatible Migration. Bei wiederholten Neustarts sollte ein Alarm ausgelöst werden, statt sie als erfolgreiche Ausfallsicherheit zu werten.

Worker-Richtlinie anhand von Queue und Beendigungsverhalten auswählen

Für einen dauerhaft laufenden Queue-Worker kann unless-stopped sinnvoll sein, wenn er kontinuierlich Aufgaben abarbeiten soll. Für einen Worker mit begrenzter Laufzeit oder einen Batch-Prozess kann on-failure:N verwendet werden, damit vorübergehende Fehler begrenzte Wiederholungsversuche auslösen, während ein dauerhaftes Problem sichtbar zum Abbruch führt.

Eine aktuelle Darstellung zu begrenzten Wiederholungsversuchen bei Fehlern betont, dass das Wiederholungsverhalten dazu passen sollte, ob ein Prozess dauerhaft laufen oder regulär beendet werden soll.

Klären Sie, was der Rückgabecode 0 für das Worker-Image bedeutet. Steht er für „Job abgeschlossen“, kann always aus einem erfolgreichen einmaligen Job eine Endlosschleife machen. Ist der Worker als Daemon gedacht, kann ein unerwarteter sauberer Abschluss dennoch einen automatischen Neustart mit unless-stopped rechtfertigen.

Single board computer zimaboard2

Halten Sie Web-Apps für den Langzeitbetrieb ausgelegt, aber starten Sie sie erst bei tatsächlich verfügbaren Abhängigkeiten

Die meisten selbst gehosteten Webanwendungen sollen dauerhaft verfügbar sein. Daher ist unless-stopped meist leichter nachvollziehbar als eine begrenzte, nur bei Fehlern greifende Richtlinie. Die Neustarteinstellung macht Datenbank, Cache, DNS, Secrets und eingebundene Pfade nicht automatisch betriebsbereit.

Die zugehörige ZimaSpace-Diagnose zu Neustartschleifen durch Container-Abhängigkeiten zeigt, warum wiederholte Neustarts der sichtbaren App den zuerst aufgetretenen Datenbank-, Cache-, Mount-, Migrations- oder Speicherfehler verschleiern können.

Verwenden Sie, wo sinnvoll, Abhängigkeits-Healthchecks, um die Startreihenfolge zu steuern, und begrenzen Sie die Wiederholungsversuche der Anwendung. Ein Webdienst, der alle fünf Sekunden abstürzt, bis PostgreSQL startet, ist schwerer zu überwachen als einer, der auf die Bereitschaft wartet und einmal sauber startet.

Geben Sie Migrationen und einmaligen Jobs einen begrenzten Lebenszyklus

Migrationscontainer, Importer, Wartungsaufgaben und einmalige Initialisierungsjobs sind keine gewöhnlichen Daemons. Ihr Erfolgszustand lautet oft „mit Rückgabecode 0 beenden und gestoppt bleiben“. Mit always oder unless-stopped kann abgeschlossene Arbeit unbeabsichtigt erneut ausgeführt werden.

Lassen Sie einmalig ausgeführte Betriebstools ausdrücklich als solche bestehen, statt sie zu versteckten, ständig laufenden Diensten zu machen. Eine Migration oder ein Importer sollte einen endgültigen Erfolgszustand haben, der nach Beendigung des Befehls sichtbar bleibt.

Verwenden Sie restart: "no", wenn ein Fehler zur Überprüfung führen soll, oder ein begrenztes on-failure nur dann, wenn der Befehl sicher wiederholt werden kann. Bei Schema-Migrationen sollten Sie nachweisen, dass eine teilweise ausgeführte Migration erneut ausgeführt werden kann, bevor Sie Wiederholungsversuche automatisieren.

Testen Sie die Richtlinie mit realen Fehlerszenarien

Testen Sie für jeden Dienst einen ordentlichen Prozessabschluss, einen Absturz mit einem Rückgabecode ungleich null, einen Hostneustart, einen Neustart des Docker-Daemons, ein manuelles Stoppen, einen Zustand, in dem der Dienst nicht gesund, aber noch aktiv ist, sowie eine nicht verfügbare Abhängigkeit. Halten Sie den erwarteten Zustand nach jedem Ereignis fest, bevor Sie die Konfiguration als ausfallsicher bezeichnen.

Erfassen Sie die Anzahl der Neustarts und lösen Sie einen Alarm aus, wenn sie innerhalb eines Zeitfensters einen niedrigen Schwellenwert überschreitet. Automatische Neustarts sollten die Wiederherstellungszeit bei vorübergehenden Fehlern verkürzen. Sie sollten einen dauerhaften Absturz nicht dadurch unsichtbar machen, dass endlos neue Container erstellt werden.

Eine gute Richtlinienmatrix ist eindeutig: Lang laufende Datenbanken und Web-Apps werden nach Infrastrukturneustarts wieder gestartet, Daemon-Worker erholen sich entsprechend der Warteschlangensemantik, zeitlich begrenzte Jobs enden nach Abschluss, und Health- und Bereitschaftsprüfungen machen Fehler sichtbar, die eine Neustartrichtlinie nicht erkennen kann.

Support und Tipps

Mehr zum Lesen

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.