Docs
Gateway service runbook

Gateway service runbook

Scope

The Gateway is the always-on process that owns channel connections and serves the control/event plane (WebSocket + HTTP Control UI).

Run locally 

moltbot gateway --port 18789
moltbot gateway --port 18789 --verbose

Service install (recommended) 

moltbot onboard --install-daemon
moltbot gateway status

Config + auth basics

  • Default config path: ~/.moltbot/moltbot.json (override via env in advanced setups).
  • Default port: 18789 (WebSocket + HTTP Control UI on the same port).
  • When you bind beyond loopback, require a token/password (see /docs/gateway/security/).

Profiles (isolate state)

  • --dev: uses ~/.moltbot-dev and shifted ports for a safe dev instance.
  • --profile <name>: uses ~/.moltbot-<name> for isolation (multiple gateways on one host).

Remote access (safe defaults)

  • SSH tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host
  • Tailscale access: /docs/gateway/tailscale/

What to verify 

moltbot status
moltbot health

Common operator pages

  • Configuration: /docs/gateway/configuration/
  • Security: /docs/gateway/security/
  • Logging: /docs/gateway/logging/
  • Troubleshooting: /docs/gateway/troubleshooting/
  • Protocol: /docs/gateway/protocol/

Further reading

  • Source path: gateway/index.md