Guides Ops Overview

Self-host Kanna under pm2, systemd, docker, or plain shell.

Kanna is a single Bun process listening on :3210 (change it with --port). Self-hosting choices:

• Self-host basics — CLI flags, persistence, ports
• pm2 — recommended for VPS deployments
• systemd — long-running service on Linux
• docker — containerised deployment
• OAuth pool admin — managing tokens at scale
• Cloudflare tunnel — share links, named tunnels, the macOS pm2 recipe, 403 on login
• Self-update — how the Update button installs a new version

Start with Self-host basics: port, password and the data directory are not configured the way most guides on the internet assume.

For the env var reference see Reference → Env Vars.