The Hermes Agent Dashboard won't open, so make sure you have installed additional web dependencies, and then check the port and binding address. The official CLI reference states that the Dashboard runs on 127.0.0.1:9119 by default and is used to manage configurations, API keys, and sessions.
Let's look at the startup method first
If you run the hermes dashboard directly, it will try to open the browser by default. If the server does not have a desktop environment, you can use hermes dashboard --no-open and then access it through an SSH tunnel or reverse proxy.
Common causes and treatment
- Prompt missing FastAPI or Uvicorn: Install Hermes dependency with web extras.
- Port occupied: Use
hermes dashboard --port 8080instead. - Remote server cannot be accessed: Only
127.0.0.1is bound by default, so don't mistakenly think that the public network can be opened directly. - Browser auto-opening failed: Manually accessed address after adding
--no-open.
Do not directly expose to the public network
Dashboard involves configuration and key management, and it is not recommended to change the host to a public address and then run naked. It is better to use SSH tunnels, local access, VPN, or reverse proxy with authentication. Temporary troubleshooting can confirm that the machine is functioning normally before handling the remote access layer.
If the dashboard starts successfully but the page is blank, continue to look at the terminal output and hermes logs, and you can generally see dependencies, ports, permissions, or front-end resource loading errors.
