wiki: publish pending edits (2026-10-20)

This commit is contained in:
Tony0410
2026-10-20 18:38:11 +08:00
parent 667ab7f41d
commit fbd4f297eb
46 changed files with 1012 additions and 197 deletions
+25 -7
View File
@@ -3,9 +3,9 @@ title: Restart Hermes
type: runbook
status: active
created: 2026-07-22
updated: 2026-07-22
verified_on: 2026-07-22
last_tested: 2026-07-22
updated: 2026-10-20
verified_on: 2026-10-20
last_tested: 2026-10-20
confidence: high
tags: [runbook, hermes, restart]
sources: [raw/configs/hermes-config-sanitized.txt]
@@ -32,17 +32,35 @@ Restart the Hermes agent, gateway, dashboard, and browser helper processes clean
```bash
ps aux | grep -E "hermes_cli.main (gateway|dashboard) run|hermes-webui/server.py|cua-driver serve|x11vnc.*5901" | grep -v grep
```
Expected active pieces on this install:
- gateway: `/home/hermes/.hermes/hermes-agent/venv/bin/python -m hermes_cli.main gateway run`
- dashboard: `/home/hermes/.hermes/hermes-agent/venv/bin/python -m hermes_cli.main dashboard ...`
- webui: `/home/hermes/.hermes/hermes-agent/venv/bin/python /home/hermes/hermes-webui/server.py`
Expected active pieces on this install (live `ps` 2026-10-20):
- gateway: `hermes gateway run` → `/home/hermes/.hermes/tools/python-3.14.7+20260901-linux-x64/bin/python3 … gateway run`
(unit `hermes-gateway.service`)
- dashboard: `hermes dashboard --host 0.0.0.0 --port 9119 --no-open` (unit `hermes-dashboard.service`)
- webui: `/home/hermes/.hermes/hermes-agent/venv/bin/python /home/hermes/hermes-webui/server.py` (port 8787)
- camofox/cua-driver: `/home/hermes/.local/bin/cua-driver serve`
- x11vnc: `-display :99 ... 5901`
> **The `venv/` path in this runbook is wrong for the gateway and dashboard (verified 2026-10-20).**
> They no longer run from `~/.hermes/hermes-agent/venv/`; they run from the **uv-managed runtime**
> `~/.hermes/tools/python-3.14.7+20260901-linux-x64/`, launched through
> `hermes_cli/main.py` with a `runpy` bootstrap. The `hermes` launcher at
> `/home/hermes/.local/bin/hermes` is a 73-byte shim. **Prefer the `hermes` CLI and the systemd
> user units over hand-written `python -m hermes_cli.main …` commands** — the units already carry
> the correct interpreter path and the `_hermes_closure_repair()` bootstrap that protects against a
> half-finished `hermes update`.
>
> **Live user units (2026-10-20):** `hermes-gateway.service`, `hermes-dashboard.service`,
> `hermes-ui.service`, `hermes-ui-prod.service`, `hermes-wiki-serve.service` — all
> `active (running)`.
### 2. Restart the gateway
```bash
hermes gateway restart
```
Equivalent and preferred (survives a broken CLI shim):
```bash
systemctl --user restart hermes-gateway.service
```
### 3. Restart the dashboard if needed
```bash