How-To Series · 9: Locking It Down

Multi-Profile Gateways

Run two or more Hermes agents at once on a single machine, each with its own tokens, sessions, and memory.

After this videoYou can keep many isolated Hermes agents online at once on one machine

Run multiple profiles as managed services on one machine. Create and install each profile's gateway, then manage them collectively with a shell-loop wrapper. The default is one process per profile for hard isolation. On a busy host you can opt in to a single multiplexing gateway with gateway.multiplex_profiles, where the default profile serves every profile, HTTP platforms route via a /p// prefix, and credentials stay per-profile. Each profile needs unique bot tokens, and the guide covers keeping the host awake on macOS and Linux.

About these resources. This episode explains how to run many Hermes gateways at once. The Sources block names the Hermes docs page that backs every claim.

Sources · What this video distills

1 docs page · every command below traces to one of them

Primary guide

Running Many Gateways at Once

Commands shown · Copy and paste

each shows the source doc it came from

Create a new profilefrom source ↗

hermes profile create coder

Install a profile's gateway as a servicefrom source ↗

coder gateway install

Opt in to a single multiplexing gatewayfrom source ↗

hermes config set gateway.multiplex_profiles true

Going deeper · Related Hermes docs

further reading · not sources of facts shown above

The basics of isolated Hermes instances.

Messaging Platforms overview

All messaging integrations at a glance.

Next in the series · Episodes that build on this