2.8 KiB
2.8 KiB
title, category, tags, created, modified, related
| title | category | tags | created | modified | related | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Hermes WebUI (Hermex-Backend) | systems |
|
2026-10-10 | 2026-10-10 |
|
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 → 401GET /api/sessions— Cold-Start 34–70 s (state.db-Scan), warm 0,2 sPOST /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 <id> --vault <v>existiert nicht →op read "op://Hermes/<id>/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