Fixing CrashLoopBackOff
What CrashLoopBackOff means and a checklist to find the root cause fast.
podscrashloopbackoffdebug
Fixing CrashLoopBackOff
CrashLoopBackOff means a container started, exited, and Kubernetes is now waiting longer and longer between restart attempts. It's a symptom, not a cause — the job is to find why the container exits.
Triage checklist
- Read the logs. Open the pod and stream its logs. The crash reason is usually in the last few lines before it died. Check the previous container instance, not just the current one.
- Check the exit code. In the pod's container status:
1is a generic app error,137is OOM-killed (out of memory),139is a segfault. - Look at events. The pod's events often show image pull errors, failed mounts, or failing probes.
- Review probes. An aggressive
livenessProbecan kill a container that's simply slow to start. LooseninitialDelaySecondsor use astartupProbe. - Confirm config. Missing or wrong environment variables, ConfigMaps, or Secrets are a frequent cause. Verify the referenced objects exist in the same namespace.
- Check resources. Exit code
137means the container exceeded its memory limit. Raise the limit or fix the leak.
In Kubexer
- The pod drawer surfaces status, the restart count, recent events, and a one-click logs stream.
- Use Resource Edit in the Workbench to adjust probes or resource limits and re-apply without leaving the app.