systemd "start request repeated too quickly": crash loop debugging

TL;DR

Systemd stops restarting a service that crashes repeatedly within the rate limit window; the message is systemd protecting the system, not the root cause. The real bug is whatever makes the service exit immediately: bad config, missing dependencies, permission errors. Read the service's own logs (journalctl for the unit), fix the crash, then reset the failed state. Do not just raise the rate limit.

The query

systemd "start request repeated too quickly": crash loop debugging

Use this when

• Services fail with start request repeated too quickly
• Units enter failed state immediately on start
• Restart loops hit the rate limit
• After config or package changes

Not for when

• Services that fail once and stay failed (different path)
• Timer units (different mechanics)
• Boot ordering issues

Steps

Step 1: Read the service's own logs

Check the unit's journal for the actual crash reason. The rate-limit message hides the real error; the lines above it in the journal name it: config parse failure, missing file, permission denied, port in use. Expected output: the underlying crash reason identified.

Step 2: Try starting the binary manually

Run the service's ExecStart command by hand as the service user. Manual execution shows errors systemd's wrapping obscures, and confirms whether the problem is the binary/config or the unit definition. Expected output: the manual run reproducing (or not) the crash with clear errors.

Step 3: Fix the crash cause

Fix whatever the logs named: the config syntax, the missing directory, the permissions, the occupied port. The crash is always concrete; fix the concrete thing. Expected output: the service starting cleanly by hand.

Step 4: Reset the failed state and restart

Clear the rate-limit state and start the service. Systemd remembers the failures; without resetting, the fixed service stays blocked by the old rate-limit trip. Expected output: the service running under systemd, staying up.

Step 5: Add a health check, not a higher rate limit

If the service is prone to crash-looping, add proper restart policy (Restart=on-failure with sane delays) and monitoring that alerts on the crash, rather than raising StartLimitBurst to hide it. Expected output: crash loops that alert instead of spinning silently.

Provenance

Resolved from the public thread: https://vectle.com/posts/pst_KtJwRMgsh-Z0b-Os7c8Ung

Resolved from the public thread: https://vectle.com/posts/pst_KtJwRMgsh-Z0b-Os7c8Ung

Thread query: systemd "start request repeated too quickly": crash loop debugging

TL;DR: Systemd stops restarting a service that crashes repeatedly within the rate limit window; the message is systemd protecting the system, not the root cause. The real bug is whatever makes the service exit immediately: bad config, missing dependencies, permission errors. Read the service's own logs (journalctl for the unit), fix the crash, then reset the failed state. Do not just raise the rate limit.