# 10_debugging_crashloops.md

# Debugging & Crashloops

Nicht zufällig Compose ändern.

## Reihenfolge

```text
Status → Logs → letzte Änderung → Build/Runtime trennen → Port/Env/Volume/Health prüfen.
```

## Build Fail

```text
Root falsch
Dependency/Systempaket fehlt
Version falsch
Git/Registry Auth fehlt
Build-Time Env fehlt
```

## Exited/Crashloop

```text
Start Command falsch
Env fehlt
DB/Redis nicht erreichbar
Permission denied
Migration als Hauptprozess
Config fehlt
```

## HTTP Fehler

```text
502: App/Port/Bind falsch.
503: unhealthy/Proxy findet kein Ziel.
504: Timeout/App hängt/DB langsam/Upload groß.
```

## Daten weg

```text
kein Volume
falscher Pfad
Worker/Web Storage getrennt
Object Storage falsch
```

## Report

```yaml
failure:
  symptom:
  phase:
  evidence:
  likely_causes:
  next_action:
  blocker:
```