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 /en/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: /en/docs/gateway/tailscale/

What to verify

moltbot status
moltbot health

Common operator pages

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

Further reading

• Source path: gateway/index.md