Thanks to visit codestin.com
Credit goes to docs.molt.bot

Skip to main content

Linux App

The Gateway is fully supported on Linux. Node is the recommended runtime. Bun is not recommended for the Gateway (WhatsApp/Telegram bugs). Native Linux companion apps are planned. Contributions are welcome if you want to help build one.

Beginner quick path (VPS)

  1. Install Node 22+
  2. npm i -g moltbot@latest
  3. moltbot onboard --install-daemon
  4. From your laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  5. Open http://127.0.0.1:18789/ and paste your token
Step-by-step VPS guide: exe.dev

Install

Gateway

Gateway service install (CLI)

Use one of these:
moltbot onboard --install-daemon
Or:
moltbot gateway install
Or:
moltbot configure
Select Gateway service when prompted. Repair/migrate:
moltbot doctor

System control (systemd user unit)

Moltbot installs a systemd user service by default. Use a system service for shared or always-on servers. The full unit example and guidance live in the Gateway runbook. Minimal setup: Create ~/.config/systemd/user/moltbot-gateway[-<profile>].service:
[Unit]
Description=Moltbot Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/moltbot gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
Enable it:
systemctl --user enable --now moltbot-gateway[-<profile>].service