Files
alan/docs/hermes.md
T

1.4 KiB

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:

./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:

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

Gezieltes Upgrade auf einen bestimmten Tag:

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