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.

​
Beginner quick paths

For a Linux laptop or desktop, run:
For an always-on VPS, SSH to the provider root shell and run the complete exact fresh Hosting command. The block authenticates the tagged installer before Bash executes it. The verified Hosting installer then installs/starts Tailscale, creates the non-root app runtime, and guides the private dashboard and SSH check. No source checkout, manual Tailscale bootstrap, or SSH tunnel is part of the normal path. Auto-install supports common Linux families: Ubuntu, Debian, Kali, Fedora, CentOS, AlmaLinux, Rocky Linux, CloudLinux, Oracle Linux, Amazon Linux, openSUSE, SLES, Alpine, and Arch. It uses the system package manager, installs Node 24 where the platform supports it, then verifies node:sqlite before setup continues. Step-by-step VPS guide: Hetzner or the general VPS hosting hub.

​
Install

​
Gateway

​
Gateway service install (CLI)

Use one of these:
Or:
Or:
Select Gateway service when prompted. Repair/migrate:

​
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:
Enable it: