Run it. Peer it. Own it.
Guides that start from what you want to do, the full per-product reference ingested straight from each repo, the HTTP API, and deep dives for self-hosters and contributors.
Using Vulos
Already up and running? Start here. Click-by-click guides to the desktop, the apps, and everyday tasks — no jargon, just what to do.
What you see and what to click — windows, the dock, and ⌘K.
Browse the app grid and install apps onto your own box.
Upload, organise, and share files with real viewer/editor roles.
Ask it anything — it confirms before it changes anything.
Passwordless sign-in, and adding people to your box.
New here? Install Vulos
Install Vulos on your own hardware
Flash the image to a mini-PC, an old laptop, a Pi, or a VPS, walk the first-boot wizard, and sign in. No developer tooling — a friendly, visual, step-by-step guide.
Read the guideCloud & reachability
Let Vulos run it for you, or self-host free — and reach your box from anywhere. Reachability is built into the OS: it uses a default relay by default, and you can bring your own at any time.
Let Vulos run it, or self-host free: what managed includes, and how billing works.
Reach your box from anywhereReach your box from anywhere — no ports to open. Default relay, or bring your own.
Connect Vulos CloudLink your box to Vulos Cloud for sign-in, routing, and updates.
How the world reaches your boxThe full reachability model — direct, relay, LAN, and TURN media.
Apps & projects
5 mini-sitesThe peripheral open-source projects keep their docs alongside their own landing page — follow the link into each product’s mini-site.
Docs, Sheets, Slides and PDF signing — a sovereign office suite.
lilmailBring-your-own-email PIM connector — a single Go binary over your inbox.
LLMuxThe sovereign LLM gateway — route AI through your own box, metered.
OpenRateRating and metering library — usage graphs and billing math.
SlipScanSelf-hosted personal finance & accounting — receipts, ledger and VAT on a local SQLite file.
When things break
Self-serve fixes for the problems that actually happen.
Developers
For people building on or self-hosting Vulos — not the way in for most people. Docker & source install, architecture, self-hosting, the control plane, and the API.
Docker, build-from-source, and every install method in one place.
OS architectureHow the shell, the Go backend, and the seams fit together.
Configuration referenceEvery environment variable and config file, in one place.
Self-host the whole suiteThe whole suite on one server, one installer.
Deploy to a VPSDeploy the OS to a VPS with a domain and TLS.
Identity & peeringVula IDs, the key lifecycle, and leaderless CRDT sync.
How the world reaches your boxReachability internals — direct/relay fallback, TURN, and the default-relay-or-BYO provider switch.
Access-cloud (deep reference)Deep access-cloud reference — login, sync, OTA, fleet.
API ReferenceEvery public control-plane HTTP endpoint, grouped, with examples.
Vulos federates over Kotva — the substrate spec family (mail, work, commerce) that lets boxes reach and trust each other without a central authority. It has its own home; these docs stay focused on the OS and its management.