Skip to main content

​
Linux App

The Gateway is fully supported on Linux. Node is the normal runtime. Bun is experimental for the Gateway because some channel adapters depend on Node behavior. Native Linux companion apps are planned. Contributions are welcome if you want to help build one.

​
Beginner quick path (VPS)

  1. git clone https://github.com/fased-ai/fased.git fased
  2. cd fased
  3. Join Tailscale on the host if this is a remote machine
  4. ./install.sh --hosting
  5. From your laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
  6. Open http://localhost:18789/ and paste your token
For a local Linux laptop/dev box, use plain ./install.sh or ./install.sh --local. The installer runs onboarding unless you pass --no-onboard. Step-by-step VPS guide: Hetzner or the general VPS hosting hub.

​
Install

​
Gateway

​
Gateway service install (CLI)

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

​
System control (systemd user unit)

Fased installs a systemd user service by default. Use a system service only when you intentionally run a shared host-level service. The full unit example and guidance live in the Gateway runbook. Minimal setup: Create ~/.config/systemd/user/fased-gateway[-<profile>].service: 
[Unit]
Description=Fased Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=%h/.local/bin/fased gateway --port 18789
Restart=always
RestartSec=5

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