spannora docs

spannora is a self-hosted web UI for Claude Code. These pages cover installing it on a Linux VM, setting up the standalone hub for multiple instances, the security and auth model, and frequently asked questions.

Start here

• Install spannora — one-line installer, manual deploy, custom domains, reverse proxy details.
• The spannora hub — manage multiple spannora installs from one PWA at spannora.dev/app/.
• Security model — authentication, the root-by-design rationale, CORS, bearer tokens.
• FAQ — common questions about Claude Code in the browser, mobile, costs, and limitations.

Beyond the docs

The source lives at github.com/gididaf/spannora. Issues and feature requests go there. The hub PWA is at spannora.dev/app/ — bring your own spannora instance URL and bearer token.

For a quickstart: provision any Linux VM with ports 80/443 open, point your DNS at it (or skip DNS and use the default sslip.io hostname), then run:

curl -fsSL https://spannora.dev/install.sh | bash

The installer takes care of HTTPS, a systemd service, the SQLite database, and a setup token. Five minutes from a fresh VM to a working chat.