AI-Profile-Router/docs/RECOVERY.md

Backup und Wiederherstellung

Athena

mike-ai-backup erzeugt alle fünf Stunden ein Archiv unter /data/docker-backups und behält 14 Tage. Gesichert werden:

• /etc/mike-ai mit lokaler Konfiguration,
• Router-Zustand und erzeugte Bilder,
• Piper-Daten,
• der kanonische Stack als zusätzlicher Snapshot.

Nicht in das Archiv gehören die großen Modellgewichte unter /data/models. Sie bleiben auf der Daten-SSD oder werden anhand der gepinnten Angaben in config/install.env.example erneut geladen. Die Dashboard-Historie liegt dauerhaft unter /data/llama-dashboard.

Der optionale Portainer-Container gehört nicht zum Athena-Kern. Seine lokale Konfiguration liegt im Docker-Volume portainer_data; ohne dessen Sicherung kann Portainer jederzeit neu angelegt und einmalig eingerichtet werden, ohne Router, Modelle oder Dashboard-Daten zu verlieren.

Neuaufbau

1. Debian installieren und /data wieder am bisherigen Pfad einhängen.

2. Dieses Repository klonen.

3. Installationsdatei ausfüllen und Installation starten:

   sudo ./install.sh --config /root/mike-ai-install.env
   

4. Letztes Datenarchiv einspielen:

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

--check liest das komplette gzip-Archiv und prüft dessen sichere /backup-Struktur sowie die benötigten Konfigurations- und Volume-Bäume, ohne Container oder Dateien zu verändern. Der reguläre Restore extrahiert und verwendet anschließend ausschließlich diesen einen geprüften Baum.

Das Restore verändert weder SSH noch LAN, WireGuard, Kernel, Partitionen oder Mounts.

Unraid

Hermes und die Fach-MCPs sind kein Bestandteil des Athena-Backups. Sie werden durch das vorhandene Unraid-Appdata-Backup gesichert:

• /mnt/nvme-storage/appdata/Hermes-Agent
• die jeweiligen Appdata-Verzeichnisse der MCP-Container
• DockerMan-Templates unter /boot/config/plugins/dockerMan/templates-user/

Container-Images stammen aus den dokumentierten Registries beziehungsweise den eigenen Gitea-Repositories. Damit besteht die Wiederherstellung aus Appdata-Restore plus Neuerstellung über die jeweilige Template-XML.

Kontrolle

docker compose --env-file /etc/mike-ai/stack.env ps
sudo ./restore.sh --check /data/docker-backups/athena-latest.tar.gz
curl -fsS http://192.168.1.212:8099/health
sudo ./smoke-test.sh

Anschließend einen Hermes-Chat, einen Router-Aufruf und je eine kleine read-only-Abfrage der benötigten MCPs testen.