Set up Hermes Agent for Herald on any computer
Herald talks to the Hermes Agent you already run. Pick the machine it runs on and follow the steps; most setups take about two minutes with npx herald-setup.
- Set up Hermes Agent on a Mac for HeraldPair Herald with Hermes Agent on your Mac in about two minutes: install Hermes, run npx herald-setup, scan the QR code and keep the Mac awake for your bots.Reviewed 20 October 2026
- Run Hermes Agent on an always-on Mac miniTurn a Mac mini into an always-on Hermes Agent host for Herald: stop it sleeping, add Tailscale, run npx herald-setup and keep Hermes running after restarts.Reviewed 20 October 2026
- Set up Hermes Agent on Linux for HeraldConnect Herald to Hermes Agent on Linux: install Hermes and Tailscale, run npx herald-setup, scan the QR code and keep hermes serve running with systemd.Reviewed 20 October 2026
- Set up Hermes Agent on Windows with WSL2Run Hermes Agent inside WSL2 and pair Herald: install Hermes in Ubuntu, run npx herald-setup there, then pick Tailscale or mirrored networking for your phone.Reviewed 20 October 2026
- Connect Herald to Hermes Agent in DockerPair Herald with Hermes Agent in Docker: keep the dashboard on 127.0.0.1, run npx herald-setup --no-serve on the host, then restart the dashboard container.Reviewed 20 October 2026
- Run Hermes Agent on a VPS and reach it from your phoneUse Herald with Hermes Agent on a VPS without exposing the dashboard: keep it on 127.0.0.1, add Tailscale and run npx herald-setup over SSH to pair.Reviewed 20 October 2026
- Run Hermes Agent on a Raspberry PiRun Hermes Agent on a Raspberry Pi with a 64-bit OS and connect Herald: install Hermes and Tailscale, run npx herald-setup, keep Hermes running with systemd.Reviewed 20 October 2026
