xvii documentation

xvii puts the everyday infrastructure of a developer or a small team on servers you own. Each piece is a small Go service with its own panel; together they share one account, one command-line tool (xvii), one look and one notion of teams and projects.

These pages document the version this instance runs (v1.0.1). Commands use this instance's domain, xvii.network, so they can be copied as they are.

Start here

Install an instance: turn a fresh Linux server into your own platform in one command.
Install the CLI and sign in: xvii on your machine, signed in with a passkey.
Deploy a static site: a folder online with a link in seconds.
Deploy an app: a container with a database, HTTPS, logs and rollbacks.

What is in the box

Service	What it does
id	accounts with passkeys, teams, projects, roles, API tokens, sign-in for everything else
home	the front door: overview, activity, search, instance administration and updates
pages	static sites and previews with aliases, custom domains and passwords
apps	containers, databases, builds, previews, bots, cron and templates on your nodes
env	encrypted variables and secrets per project environment
domains	DNS on Cloudflare or xvii's own name servers, custom names in one step
notify	every event delivered to Telegram, e-mail, push or webhooks
backups	scheduled, encrypted backups of the whole instance, with restores
status	uptime monitors, heartbeats, incidents and public status pages
errors	error tracking that speaks the Sentry protocol
analytics	cookie-less web analytics
tunnel	a public HTTPS address for a port on your laptop
hooks	catch, inspect, replay and forward webhooks
ai	one OpenAI, Anthropic and Gemini compatible endpoint with keys and quotas
share	files, pastes and short links with a lifetime
config	feature flags and remote config
mail	a mail server with webmail for your domains
docs	this documentation

How the documentation is organised

Get started takes you from nothing to a running site and app.
Guides show how to do one thing well: databases, custom domains, CI, monitoring.
Operations is for whoever runs the instance: updates, backups, nodes, users.
CLI documents every xvii command.
Services describes each service: addresses, concepts, limits, events.
Reference covers the API, configuration files, limits and events.

Press / or ⌘ K to search. Every page is also available as Markdown: add .md to its address, or use Copy page.