Linux App

Scope

The Gateway is fully supported on Linux. Node.js is the recommended runtime; Bun is not recommended for Gateway channel stability.

Native Linux companion apps are planned (Gateway-first is the current model).

Beginner quick path (VPS)

1. Install Node.js 22+
2. Install Moltbot
3. Run onboarding and install the service
4. Access the UI via SSH tunnel (or Tailscale)
5. Verify status + health

Example:

curl -fsSL https://clawd.bot/install.sh | bash
moltbot onboard --install-daemon

From your laptop:

ssh -N -L 18789:127.0.0.1:18789 user@host

Open http://127.0.0.1:18789/.

Install and updates

• Install hub: /docs/install/
• Updating: /docs/install/updating/
• Docker option: /docs/install/docker/

Gateway operations

• Runbook: /docs/gateway/
• Configuration: /docs/gateway/configuration/
• Logging: /docs/gateway/logging/

Service install (systemd user unit)

Common commands:

moltbot gateway install
moltbot gateway status
moltbot gateway restart

If you need to manage the service directly:

systemctl --user status moltbot-gateway.service
journalctl --user -u moltbot-gateway.service -f

Verify

moltbot status
moltbot health

Further reading

• Source path: platforms/linux.md