wiki: publish pending edits (2026-10-20)
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user