Auto-sync: 2026-10-10

This commit is contained in:
Dominik Schön
2026-10-10 22:00:06 +00:00
parent 36520a7851
commit 66a3e993ea
12 changed files with 429 additions and 30 deletions
+54
View File
@@ -0,0 +1,54 @@
---
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 <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`