# Hermes in diesem Setup

## Betriebsmodus

Dieses Repo faehrt Hermes **im Container** als Gateway.

Wichtige Daten landen in `./state/hermes`, das auf `/opt/data` im Container gemountet wird. Laut offizieller Doku ist `/opt/data` der Single Source of Truth fuer Config, Sessions, Skills, Memories und Logs.

## Initialisierung

1. `./scripts/alanctl bootstrap`
2. `./scripts/alanctl init-hermes`
3. `./scripts/alanctl up`

`init-hermes` startet den offiziellen Setup-Wizard interaktiv.

## Dashboard

Optional:

```bash
./scripts/alanctl up --dashboard
```

Danach ist das Dashboard standardmaessig auf `http://127.0.0.1:19119` erreichbar.

## Wichtige Hinweise

- Nicht zwei Hermes-Gateway-Container gegen dasselbe Datenverzeichnis starten.
- Falls du spaeter Messaging-Plattformen oder Provider-Keys nutzt, verwalte sie im Hermes-Datenordner bzw. in dessen `.env`.
- Fuer Browser-Tools ist `shm_size=1g` gesetzt.


## Update-Betrieb

Empfohlener Alltag:

```bash
./scripts/alanctl pin-hermes stable
./scripts/alanctl update-hermes
```

Gezieltes Upgrade auf einen bestimmten Tag:

```bash
./scripts/alanctl update-hermes v0.9.3
```

Der Update-Workflow macht automatisch:

1. Backup des Hermes-State
2. Pull des Ziel-Images
3. Recreate des Containers
4. Warten auf erfolgreichen Healthcheck
5. automatisches Zurueckstellen auf den vorherigen Tag bei Fehlern

Der zuletzt erfolgreiche Stand wird lokal gespeichert und kann mit `rollback-hermes` erneut ausgerollt werden.