Linux App

The Gateway is fully supported on Linux. Node is the recommended runtime.

Native Linux companion apps are planned. Contributions are welcome if you want to help build one.

Beginner quick path (VPS)

1. Install Kurahi: curl -fsSL https://kurahi.com/install.sh | bash (the bundle ships its own Node.js)
2. kurahi service status to confirm the service is running
3. From your laptop: ssh -N -L 18789:127.0.0.1:18789 <user>@<host>
4. Open http://127.0.0.1:18789/ and paste your token

Step-by-step VPS guide: exe.dev

Install

• Getting Started
• Install & updates
• Optional flows: Nix, Docker

Gateway

• Gateway runbook
• Configuration

Gateway service install (CLI)

Use one of these:

kurahi onboard --install-daemon

Or:

kurahi gateway install

Or:

kurahi configure

Select Gateway service when prompted.

Repair/migrate:

kurahi doctor

System control (systemd user unit)

Kurahi 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/kolo-gateway[-<profile>].service:

[Unit]
Description=Kurahi Gateway (profile: <profile>, v<version>)
After=network-online.target
Wants=network-online.target

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

[Install]
WantedBy=default.target

Enable it:

systemctl --user enable --now kolo-gateway[-<profile>].service