docs(betrieb): Einrichtung Schritt fuer Schritt dokumentieren (#029)
Vier Anleitungen unter docs/betrieb/: Inbetriebnahme in der richtigen Reihenfolge, HTTPS mit nginx Proxy Manager sowie netbird als privates Netz, OIDC mit authentik samt Fehlerbildern, und Sicherung einschliesslich Zurueckspielen. Beim Aufschreiben zwei Fehler gefunden, die nur hinter einem Reverse Proxy auftreten: Die OIDC-Rueckkehradresse uebersah die im Dashboard eingetragene Adresse, und beim Einloesen des Codes wurde die interne Adresse verwendet - der Anbieter haette den Tausch abgelehnt. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,40 @@
|
||||
# Sicherung und Wiederherstellung
|
||||
|
||||
## Was gesichert werden muss
|
||||
|
||||
| Sache | Wo | Ohne sie |
|
||||
|---|---|---|
|
||||
| Datenbank | PostgreSQL | alles weg: Hosts, Kunden, Laufzeiten, Rechnungen |
|
||||
| `APP_SECRET` | `.env` | alle Sitzungen ungültig, SMTP- und Webhook-Zugangsdaten unlesbar |
|
||||
| Hochgeladene PDFs | `/data/uploads` (Docker-Volume) bzw. `/opt/proxledger/data/uploads` | Rechnungsanhänge fehlen |
|
||||
|
||||
Die Agents brauchen **keine** Sicherung: Sie registrieren sich neu, und die Zuordnung hängt an der
|
||||
Maschinenkennung, nicht an einem Token.
|
||||
|
||||
## Sichern
|
||||
|
||||
```bash
|
||||
bash deploy/backup.sh # Datenbank und Uploads
|
||||
```
|
||||
|
||||
Beim LXC-Weg reicht zusätzlich die gewohnte Proxmox-Sicherung des Containers.
|
||||
|
||||
## Zurückspielen
|
||||
|
||||
```bash
|
||||
# Docker
|
||||
docker compose down
|
||||
docker compose up -d postgres
|
||||
gunzip -c sicherung.sql.gz | docker compose exec -T postgres psql -U proxledger proxledger
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
Danach die `.env` mit **demselben** `APP_SECRET` zurücklegen wie zum Zeitpunkt der Sicherung. Ein
|
||||
anderer Wert lässt die gespeicherten Zugangsdaten unlesbar werden; das Dashboard sagt das beim
|
||||
nächsten Versand deutlich, aber die Werte müssen dann neu eingetragen werden.
|
||||
|
||||
## Das Wichtigste
|
||||
|
||||
**Eine Sicherung, die nie zurückgespielt wurde, ist keine Sicherung.** Spielen Sie sie einmal in eine
|
||||
leere Testumgebung ein und melden Sie sich dort an. Erst dann wissen Sie, dass Sicherung und
|
||||
`APP_SECRET` zusammenpassen.
|
||||
Reference in New Issue
Block a user