AI-Profile-Router/docs/RECOVERY.md

Backup und Wiederherstellung

Was automatisch gesichert wird

Der Container mike-ai-backup erstellt alle fünf Stunden ein komprimiertes Archiv unter /data/docker-backups und behält 14 Tage. Während der kurzen Sicherung wird nur OpenWebUI angehalten, damit seine SQLite-Datenbank konsistent ist. Netzwerk, WireGuard, Router, Hermes und Qwen bleiben erreichbar.

Enthalten sind:

• /etc/mike-ai mit lokalen Konfigurationen und Secrets
• OpenWebUI-Daten
• Router-Zustand und Router-Bildablage
• Piper-Daten
• TinySearch-Modellcache
• ein Quellbaum-Snapshot als zusätzliche Bequemlichkeit

Nicht kopiert werden /data/models, /data/hermes und /data/hermes-webui: Sie liegen bereits dauerhaft auf der Daten-SSD und überleben den Austausch der Debian-Systemplatte. Docker-Images werden aus dem Compose-Stack reproduziert und gehören nicht ins Backup.

Manuelles Backup

docker exec mike-ai-backup backup

Die Datei /data/docker-backups/athena-latest.tar.gz zeigt danach auf das neueste erfolgreiche Archiv.

Neuaufbau

1. Debian installieren und /data wieder unter demselben Pfad einhängen.

2. Repository klonen.

3. Installation einmal ausführen:

   sudo ./install.sh --config config/install.env
   

4. Zustand mit einem Befehl wiederherstellen:

   sudo ./restore.sh /data/docker-backups/athena-latest.tar.gz
   

Das Restore stoppt ausschließlich Container, deren Volumes zurückgeschrieben werden. SSH, LAN und WireGuard werden nicht verändert.

Kontrolle

docker compose --env-file /etc/mike-ai/stack.env ps
test -s /data/docker-backups/athena-latest.tar.gz

Danach einen OpenWebUI-Login, einen Router-Request und je einen read-only MCP-Aufruf testen. Alte Recovery-Koffer sind für Neuinstallationen nicht mehr erforderlich; Git plus dieses Datenbackup bilden die Wiederherstellung.