Kuglers Auth
Betrieb
Pflege, Backups, Restore und Troubleshooting.
Betrieb
Kuglers Auth ist ein produktiver Auth-Dienst. Änderungen sollten nachvollziehbar und mit Healthcheck geprüft werden.
Status prüfen
cd /home/manuelkugler/websites/kuglers-auth
docker compose ps
curl -fsS https://auth.kuglers.at/api/health
Erwartung:
{"app":"ok","database":"ok","redis":"ok"}
Logs ansehen
docker compose logs app --tail 120
docker compose logs postgres --tail 80
docker compose logs redis --tail 80
App neu bauen
docker compose up -d --build app
Datenbankmigrationen
docker compose exec app npm run prisma:deploy
Backup
PostgreSQL ist der wichtige persistente Zustand.
docker compose exec postgres pg_dump -U "$POSTGRES_USER" "$POSTGRES_DB" > kuglers-auth.sql
Redis speichert nur kurzlebige Rate-Limit-Daten und ist für Restore nicht kritisch.
Restore
docker compose exec -T postgres psql -U "$POSTGRES_USER" "$POSTGRES_DB" < kuglers-auth.sql
docker compose up -d app
curl -fsS https://auth.kuglers.at/api/health
Admin-Passwort zurücksetzen
Das Passwort eines bestehenden Admins kann über den CLI-Befehl neu gesetzt werden:
ADMIN_EMAIL=[email protected] ADMIN_NAME="Manuel Kugler" ADMIN_PASSWORD="<neues-passwort>" docker compose exec app npm run create-admin
Das Passwort sollte mindestens 12 Zeichen lang sein.
Troubleshooting
| Symptom | Prüfung |
|---|---|
| App ist nicht healthy | docker compose logs app --tail 120 |
| Datenbankfehler | DATABASE_URL und Postgres-Health prüfen. |
| Redis-Fehler | REDIS_URL und Redis-Health prüfen. |
| Login lädt nicht | Caddy-Redirects und /api/csrf prüfen. |
| Domain löst nicht auf | DNS A-Record oder lokalen DNS-Rewrite prüfen. |
| Adminpanel nicht erreichbar | Prüfen, ob der User Gruppe admin hat. |
Verschieben in Kuglers Docs
Dieser Ordner ist für Nuxt Docus vorbereitet.
Zielpfad:
/home/manuelkugler/websites/docs/content/de/4.kuglers-auth
Kopieren:
cp -a /home/manuelkugler/websites/kuglers-auth/docs/4.kuglers-auth /home/manuelkugler/websites/docs/content/de/
Danach Kuglers Docs neu bauen oder den vorhandenen Content-Workflow verwenden.
Zuletzt aktualisiert: 2. Juni 2026