Backups und Wiederherstellung

Studio- und Runtime-Datenvolumes sichern und wiederherstellen.

Backups und Wiederherstellung

Open Ticket AI speichert den eigenen Zustand in zwei SQLite-Datenbanken plus .env. Ticketinhalte bleiben in Ihrem Ticketsystem — sichern Sie die mit Ihrer bestehenden OTOBO- / Zammad- / KIX- (oder Datenbank-)Strategie.

Was ein Backup enthält

Jedes Archiv unter backups/otai-backup-<timestamp>.tar.gz enthält:

ElementZweck
Studio-SQLite (otai-studio.db)AI Tasks, Optionen, Config-Audit
Runtime-SQLite (otai-runtime.db)Workflow-Laufhistorie / KPIs
.envLizenzschlüssel, Connector-Zugangsdaten, Versions-Pins
docker-compose/Compose-Snapshot dieser Installation
meta.jsonVersion, Zeitstempel, Volume-Namen

Standard-Aufbewahrung: die letzten 14 Archive (OTAI_BACKUP_KEEP zum Ändern).

Backup erstellen

otai backup

Der Befehl gibt den Archivpfad aus. Datenbanken werden nach Möglichkeit über die Online-Backup-API von SQLite über die laufenden Container gesichert.

Periodische Backups

Die Installation fragt, ob tägliche Backups standardmäßig aktiviert werden sollen. Später ändern:

otai backup --schedule daily    # cron um 02:30 lokal
otai backup --schedule weekly
otai backup --schedule off

Als root schreibt das nach /etc/cron.d/otai-backup. Sonst wird die crontab des aktuellen Users genutzt. Ist cron nicht verfügbar, gibt die CLI eine Zeile aus, die Sie in Ihren bestehenden Scheduler einfügen können.

Mit Ihrer allgemeinen Backup-Strategie kombinieren

  1. Führen Sie otai backup im gleichen Rhythmus wie andere App-Configs aus (nächtlich ist in Ordnung).
  2. Kopieren oder synchronisieren Sie das Verzeichnis backups/ der Installation auf verschlüsselten Off-Host-Speicher (dasselbe Werkzeug wie für VM- / Dateisystem- / Object-Backups).
  3. Sichern Sie die Ticketsystem-Datenbank weiterhin separat — OTAI-Backups ersetzen das nicht.
  4. Behandeln Sie .env-Geheimnisse wie andere Credentials (das Backup-Archiv enthält sie; schützen Sie die Freigabe entsprechend).

Merksatz: OTAI-Backup = kleine Config- + History-Dateien; Ticket-DB = große Betriebsdaten.

Wiederherstellung

otai restore latest
# oder:
otai restore /path/to/otai-backup-20260726T120000Z.tar.gz

Restore stoppt Studio und Runtime, schreibt .env und Compose aus dem Archiv, lädt beide Datenbanken in die benannten Volumes, startet den Stack und führt otai verify aus.

Disaster-Recovery-Reihenfolge

  1. Ticketsystem wiederherstellen / starten (falls nötig).
  2. OTAI-Installationsbaum wiederherstellen (Compose + CLI), falls der Host neu aufgesetzt wurde.
  3. otai restore <archiv> (oder backups/ wiederherstellen und dann otai restore latest).
  4. otai verify bestätigen und prüfen, dass Studio sich aus dem Ticketsystem öffnen lässt.

Verwandt