Wenn etwas nicht geht

Die häufigsten Fälle, ihre Ursache und der konkrete Handgriff.

Zwei Griffe lösen die meisten Rätsel: der Gesundheits-Check unter /api/health (läuft der Shop, stimmt die Datenbank, welche Version?) und das Container-Log:

Log ansehen (Strg+C beendet die Ansicht)

cd /opt/vault/docker && docker compose --env-file ../.env logs -f app

Häufige Fälle

Symptom	Ursache	Handgriff
Der Build bricht mittendrin ab	Zu wenig Arbeitsspeicher — der häufigste Installationsfehler auf kleinen Servern	2 GB Swap anlegen und `install.sh` erneut starten — es bietet dir das selbst an
Login geht einfach nicht, ohne Fehlermeldung	`APP_URL` in `.env` passt nicht zur Adresse im Browser (http/https, www, Port)	`APP_URL` exakt auf die Browser-Adresse setzen, Container neu starten
Seite lädt, aber ohne Styles/Bilder	Nur bei Handinstallation: die drei Kopierschritte nach dem Build fehlen	Kapitel Fortgeschritten — die drei `cp`-Befehle sind Pflicht
Betreiber-Passwort vergessen	—	„Passwort vergessen?" auf der Anmeldeseite — braucht eingerichtete E-Mail
Einrichtung hängt fest	Abgebrochener Assistent	`pnpm reset:install` setzt nur den Assistenten zurück
Container läuft, meldet sich aber nicht gesund	Meist Datenbank noch nicht bereit oder `.env` unvollständig	Log ansehen (Befehl oben) — die erste rote Zeile nennt den Grund