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: 
crocbot onboard --install-daemon
Or: 
crocbot gateway install
Or: 
crocbot configure
Select Gateway service when prompted. Repair/migrate: 
crocbot doctor

​
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: 
[Unit]
Description=crocbot Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

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

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