# 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

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

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

4. Zustand mit einem Befehl wiederherstellen:

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

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