systemd: Start request repeated too quickly (start-limit-hit)

So sieht die Meldung aus

myapp.service: Start request repeated too quickly.
myapp.service: Failed with result 'start-limit-hit'.
Failed to start myapp.service - My application.

Häufige Ursachen

• Das Programm beendet sich direkt nach dem Start: falsche Konfiguration, fehlende Datei, Rechteproblem oder ein schon belegter Port.
• Restart=always mit sehr kurzem RestartSec startet einen kaputten Dienst zu oft neu.
• Eine Abhängigkeit (Datenbank, Mount, Netzwerk) ist noch nicht bereit.
• Mehr als 5 Starts in 10 Sekunden, die Standardwerte von StartLimitBurst und StartLimitIntervalSec.
• Ein fehlerhaftes Update hat eine Binärdatei oder Konfiguration verändert.

Prüfen

1. Zustand und letzte Zeilen der Unit
   systemctl status myapp --no-pagerKopieren
2. Warum ist sie abgestürzt? Das Journal der Unit lesen
   journalctl -u myapp -n 50 --no-pagerKopieren
3. Die für diese Unit geltenden Limits
   systemctl show myapp -p Restart -p RestartUSec -p StartLimitBurst -p StartLimitIntervalUSecKopieren

Lösung

• Zuerst den echten Fehler im Journal finden und beheben (Konfiguration, Rechte, Port, Abhängigkeit).
• Den Fehlerzustand löschen: systemctl reset-failed myapp, dann systemctl start myapp.
• Dem Dienst Luft geben: RestartSec=5 in [Service] und bei Bedarf StartLimitIntervalSec=60 sowie StartLimitBurst=5 in [Unit].
• After= und Requires= für Abhängigkeiten ergänzen, die zuerst bereit sein müssen.
• Nach dem Bearbeiten der Unit-Datei systemctl daemon-reload ausführen.

Häufige Fragen

Kann ich das Startlimit einfach erhöhen?

Man kann, aber es verdeckt nur eine Absturzschleife. Zuerst klären, warum der Prozess endet. Das Limit nur für einen Dienst erhöhen, der bewusst oft neu starten soll.

Wie sehe ich alle fehlgeschlagenen Units?

Mit systemctl --failed.