Self-Host Sygen (Advanced / CLI)

For technical users. Most people should use the managed cloud server via subscription right in the app ("Get Started" → Sygen Plus). Self-hosting is for those who want their own hardware and their own API keys. It’s free, but you set up networking/HTTPS yourself.

Requirements

A Mac (Apple Silicon/Intel) or a Linux server (Ubuntu/Debian).
To reach it from your phone — Tailscale (gives an HTTPS address out of the box; recommended). Without it you need your own domain + port forwarding.
Your own AI provider key (Claude / Gemini / Codex) — Sygen connects it on first login.

Install

With Tailscale (recommended — your phone reaches it over HTTPS):

curl -fsSL https://install.sygen.pro/install.sh | SELF_HOSTED_MODE=tailscale bash

Local-only on this machine (no remote access):

curl -fsSL https://install.sygen.pro/install.sh | SELF_HOSTED_MODE=localhost bash

Your own public domain (instead of Tailscale):

curl -fsSL https://install.sygen.pro/install.sh | SELF_HOSTED_MODE=publicdomain bash

OS-specific notes — the install command above is the same on both (the script auto-detects your OS):

Run as your normal user (do not use sudo/root).
Installs dependencies via Homebrew.
Modes: localhost (this Mac only) or tailscale (reach it from your phone). Default without Tailscale = localhost.

When it finishes, the installer prints your server URL and admin login/password.

Connect in the app

Open the Sygen app → Add server.
Paste the URL (e.g. your Tailscale address https://<machine>.<tailnet>.ts.net) + the login/password from the installer output.
Done. A Sygen Plus subscription (if you have one) unlocks Pro on this server too.

Updates

Updates run through the app: when a new core version ships, an "Update available" banner appears in the app — confirm it.

Uninstall

curl -fsSL https://install.sygen.pro/uninstall.sh | bash

Stops services, removes the venv and Sygen data from the machine.

Notes

HTTPS is required (the app won’t connect over http://). Tailscale handles this automatically.
Your data (chats, files, memory) stays on your machine — we don’t see it.
Need help? Contact support.