--- title: Hermes WebUI (Hermex-Backend) category: systems tags: [hermes, hermex, ios, webui, systemd, mobile] created: "2026-10-10" modified: "2026-10-10" related: [systems/hermes-agent-01, systems/sarah-hermes, reference/ip-map] --- # Hermes WebUI (Hermex-Backend auf hermes-agent-01) Third-Party-Server **hermes-webui** (github.com/nesquena/hermes-webui) als Backend für die iOS-App **Hermex**. NIEMALS verwechseln: Hermex spricht NICHT mit dem offiziellen `hermes dashboard` (:9119) — das ist ein anderes Protokoll. ## Stack | Komponente | Wert | |---|---| | Service | systemd `hermes-webui-dominik.service` (system-weit, enabled) | | Binary | `/opt/hermes-webui/server.py` unter `/home/debian/hermes-agent/venv/bin/python3` (Agent-Venv = Superset; Server importiert Agent-Module in-process) | | Listen | `0.0.0.0:8790` (LAN-only; Runner 10.0.30.230) | | Auth | `HERMES_WEBUI_PASSWORD` (1P Vault Hermes → Item `dominik-hermes-webui`, bgjgnoe57n2uteyqzqvoodgtqq); Signed-Cookie, Key auto-gen in `~/.hermes/webui/.signing_key` | | Agent-Integration | `HERMES_HOME=/home/debian/.hermes`, `HERMES_WEBUI_AGENT_DIR=/home/debian/hermes-agent` (Checkout liegt NICHT unter ~/.hermes/hermes-agent!) | | Cron | KEIN Scheduler-Thread im WebUI-Prozess — Scheduler bleibt allein im Gateway, WebUI nur API-Zugriff auf jobs.json (Doppel-Feuer ausgeschlossen) | | State | WebUI-eigene Sessions in `~/.hermes/webui/`; CLI/Telegram-Sessions via state.db-Bridge sichtbar (read-only für alte, materialisierbar) | | Logs | `/var/log/hermes-webui/dominik.log`, logrotate daily×7 (`/etc/logrotate.d/hermes-webui`; logrotate musste auf dem Runner nachinstalliert werden) | ## Hermex-Verbindungswerte (iOS-App) - **Server-URL**: `http://10.0.30.230:8790` - **Passwort**: 1Password Vault „Hermes" → `dominik-hermes-webui` Unterwegs nur via VPN (WireGuard) erreichbar — bewusst kein Internet-Exposure. ## API-Spickzettel - `GET /health`, `GET /api/auth/status` (password_auth_enabled) - `POST /api/auth/login` `{password}` → Cookie; falsches PW → 401 - `GET /api/sessions` — Cold-Start 34–70 s (state.db-Scan), warm 0,2 s - `POST /api/session/new` → eigene hex-ID (mitgegebenes session_id-Feld wird IGNORIERT) - `POST /api/chat` `{session_id, message}` → `{status:"done", answer}` (Agent-Subprocess) - Chat auf fremde CLI/TG-Session-ID → KeyError/500 (read-only) ## Pitfalls - `op item view --vault ` existiert nicht → `op read "op://Hermes//password"` - Unit-Templating per sed-%-Format zerstört Unit (static, Garbage-PW) → Python-Substitution - Gateway-Self-Guard blockiert kombinierte Terminal-Commands mit `state.db`-Strings nearby (False-Positive) → aufteilen ## Verwandt - Sarahs Instanz: [[systems/sarah-hermes]] (VM107, Docker-Variante :8787) - Solution Doc: `docs/solutions/integrations/2026-10-10-hermex-ios-hermes-webui-backend.md`