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.

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 /data/docker-backups/athena-latest.tar.gz
   sudo ./smoke-test.sh
   

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
test -s /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.