Hermes

Hermes "Gateway inaccessible: service_manager_unavailable"

Last checked

The error

Error: Gateway inaccessible: service_manager_unavailable

[boot] Desktop boot failed: Gateway inaccessible (service_manager_unavailable). Use hermes gateway status for recovery.

The first line is the CLI (for example hermes -z), as quoted in issue #143657. The second is Hermes Desktop's log, as quoted in issue #150136.

Before starting a gateway, Hermes asks your operating system's service manager whether a gateway service is already installed. It got an answer it could not use, so it stopped rather than risk two gateways. Run hermes gateway status and hermes gateway restart; if the service is broken, run the gateway in the foreground with hermes gateway run, or reinstall the service.

Why it happens

Hermes checks systemd on Linux, launchd on macOS, Task Scheduler on Windows and s6 in the Docker image. When that query fails or returns something unreadable, the gateway check ends with the reason code service_manager_unavailable and no model request is made.

  1. Linux: systemctl show fails or the gateway unit is not loaded, for example on WSL2 without systemd or when the user bus is not running.
  2. macOS without a GUI login session (a LaunchDaemon or sudo -u): launchctl answers the gui domain with an error that Hermes treats as an unavailable service manager (issue #143657, reported on v0.22.3 to v0.22.5, open).
  3. Windows profile paths with characters outside the console code page: schtasks replaces them with ?, Hermes cannot open the launcher path and reports this code although Task Scheduler is healthy (issue #150136, open).
  4. Localized Windows hosts where Task Scheduler output could not be decoded (issue #139083, closed).

The fix

  1. 1 Run hermes gateway status to see what Hermes finds.
  2. 2 Try hermes gateway restart.
  3. 3 On Linux, check the service directly with systemctl --user status hermes-gateway, and enable systemd in WSL2 if it is off.
  4. 4 To get working now, run the gateway in the foreground with hermes gateway run.
  5. 5 If the installed service is broken, recreate it with hermes gateway uninstall, then hermes gateway install.
hermes gateway status

Still failing?

  • On macOS, run the same command from a logged-in GUI session; if it works there, you are hitting issue #143657.
  • On Windows, check whether your user profile path contains non-Latin characters (issue #150136).
  • Other codes after Gateway inaccessible, such as profile_parked or profile_mismatch, are different problems; hermes gateway status explains them.

Related errors

Full guideHermes Agent Not Working? 14 Errors and Their Exact Fixes

Hit a different error?

Paste any agent error and get the cause and fix in seconds.

Open the decoder

Frequently asked questions

Is my gateway broken?

Not necessarily. On macOS and Windows the open issues show a healthy service manager being misread. A gateway that is already running keeps working; the error appears when Hermes has to cold-start one.

Can I skip the service manager entirely?

Yes. hermes gateway run starts the gateway in the foreground, which avoids the installed service until the bug is fixed or the service is repaired.

Stop firefighting agent errors

Decoding errors one at a time is the manual version of what BetterClaw automates. Run your agents on a no-code AI agent platform with managed models, retries and config validation built in.

Deploy Your Agent — Start FreeBook a Demo

Free plan available · Pro $49/mo · BYOK · 7-day free trial