Updates und Backups
Selbst gehostetes PDF Redaction Studio auf neue Docker-Images aktualisieren, die Postgres-Datenbank sichern, wiederherstellen und Browserdaten verstehen.
Studio aktualisieren
Im Ordner, der docker-compose.yaml enthält:
docker compose pull
docker compose up -dpull lädt die neuesten Images herunter, und up -d erstellt die geänderten Container neu. Das Backend übernimmt beim Start alle Datenbankänderungen. Ihre .env, die Datenbank in ./data und die zwischengespeicherten Modelle bleiben erhalten.
Vor einem großen Update sichern Sie die Datenbank. Was sich geändert hat, steht im Changelog.
Was gesichert werden sollte
| Daten | Wo | Wie |
|---|---|---|
| Konten, Workspaces, Projekte, synchronisierte Dokumente | Postgres, in ./data | Datenbank-Dump |
| Einstellungen und Lizenz | .env | Kopieren Sie die Datei und bewahren Sie sie sicher auf; sie enthält Secrets |
| Erkennungsmodelle | ~/.cache/huggingface auf dem Host | Optional. Fehlende Modelle werden erneut heruntergeladen |
| Nie synchronisierte Dokumente | Im Browser des jeweiligen Nutzers | Nicht auf dem Server. Nutzer sollten Dokumente, die sie behalten müssen, synchronisieren |
Datenbank sichern
docker compose exec -T db pg_dump -U postgres db > studio-backup-$(date +%F).sqlFühren Sie den Befehl regelmäßig aus, zum Beispiel mit cron, und speichern Sie die Dateien außerhalb des Servers.
Datenbank wiederherstellen
docker compose stop backend studio
docker compose exec -T db psql -U postgres -c "DROP DATABASE db;" -c "CREATE DATABASE db;"
docker compose exec -T db psql -U postgres db < studio-backup-2026-10-30.sql
docker compose up -dVerwenden Sie im dritten Befehl den Namen Ihrer Backup-Datei.
Studio auf einen anderen Server umziehen
- Sichern Sie die Datenbank und kopieren Sie
.envunddocker-compose.yaml. - Installieren Sie Docker auf dem neuen Server und legen Sie die Dateien in einen neuen Ordner.
- Führen Sie
docker compose up -d dbaus, stellen Sie das Backup wieder her und führen Sie danndocker compose up -daus. - Passen Sie die öffentlichen URLs in
.envan, falls sich die Adresse geändert hat, siehe Konfiguration.
Nächste Schritte
Lizenz
So funktioniert die Lizenz für selbst gehostetes PDF Redaction Studio: Test- oder kommerziellen Schlüssel holen, in .env eintragen, Ablauf und Ersetzen.
Fehlerbehebung
Lösungen für häufige Probleme in PDF Redaction Studio: Backend startet nicht, Anmeldung schlägt fehl, Verarbeitung hängt, fehlende Credits, Sync-Fehler.