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 (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 crocbot@latest
  3. crocbot 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:
Or:
Or:
Select Gateway service when prompted. Repair/migrate:

​
System control (systemd user unit)

crocbot 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/crocbot-gateway[-<profile>].service:
Enable it: