# 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:

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

4. Letztes Datenarchiv einspielen:

   ```bash
   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

```bash
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.