Backup & Restore (Desktop)

Admin

Nur Desktop. Im Web-/Server-Betrieb gibt es diese Funktion nicht – dort sichern Sie Datenbank und Volumes auf Infrastrukturebene.

Ziel

Den gesamten Datenbestand einer Desktop-Installation in eine verschlüsselte, portable .zip-Datei sichern und auf demselben oder einem anderen Rechner wiederherstellen. Eine Passphrase schützt sowohl die Nutzdaten (AES-256-GCM) als auch die enthaltenen API-Schlüssel, die beim Wiederherstellen auf den Zielrechner umgeschlüsselt werden.

Voraussetzungen

Rolle Administrator, Desktop-App geöffnet.
Eine sicher verwahrte Passphrase. ⚠️ Geht die Passphrase verloren, ist die Sicherung unwiederbringlich – es gibt keine Hintertür.
Ausreichend Speicherplatz am Zielort (externes Laufwerk/Cloud empfohlen).

Sicherung erstellen

Admin → Sicherung öffnen.
Passphrase eingeben und bestätigen (beide Felder müssen übereinstimmen).
Ordner wählen – Zielordner über den nativen Dialog auswählen.
Sicherung erstellen klicken.
Nach Erfolg zeigt die App den Dateipfad an; die Passphrase-Felder werden geleert.

Wiederherstellen

Die Wiederherstellung erfolgt beim nächsten Start (Swap-on-next-start), damit keine geöffnete Datenbank überschrieben wird.

Admin → Sicherung öffnen.
Sicherung wählen: Datei wählen (.zip) oder einen Auto-Snapshot aus der Liste.
Passphrase der Sicherung eingeben.
Wiederherstellen klicken (erste Bestätigungsstufe).
Bestätigen – die Wiederherstellung wird vorbereitet (Staging + pending-restore.json); die App fordert zum Neustart auf.
Jetzt neu starten – beim Hochfahren werden die Dateien ersetzt, bevor eine Datenbank geöffnet wird; anschließend wird der Vektor-Speicher neu aufgebaut (er ist bewusst nicht Teil der Sicherung).

Wiederherstellung in zwei Phasen: Vorbereiten im laufenden Betrieb, Tausch und Neuindizierung beim Neustart.

Verifikation

Nach dem Neustart: Anmeldung möglich, Wissensbasis-Suche liefert Treffer (Neuindizierung abgeschlossen).
Modellanbieter/MCP-Server: API-Schlüssel funktionieren (erfolgreich umgeschlüsselt).

Troubleshooting

„Schema blockiert” beim Wiederherstellen – die Sicherung stammt aus einer neueren App-Version. Erst die App aktualisieren, dann erneut wiederherstellen.
Falsche Passphrase – Entschlüsselung schlägt fehl; keine Daten werden verändert. Korrekte Passphrase verwenden.
Neuindizierung scheint zu fehlen – ohne Qdrant/sqlite-vec nutzt die App BM25 (kein expliziter Reindex nötig).

Grenzen

Passphrase-Verlust = Totalverlust der Sicherung.
messaging.db wird per EnsureCreated geführt – bei einer Wiederherstellung über Versionsgrenzen hinweg werden neue Spalten nicht nachgezogen.
Lizenzstatus wandert nicht mit (maschinengebunden, liegt unter secure/).