Self-hosters

Server

Running the server yourself with Docker or from source: setup, accounts, voice, content, backups, updates and troubleshooting.

Server overview and requirementsWhat the server is, when to run one instead of hosting from the app, the hardware it needs with and without a local model, the single-process rule, the ports it uses, and where its data lives on disk.
Server
Run with DockerThe compose file, the images on Docker Hub and GHCR, the encryption key and setup code printed on first boot, the six volumes, pointing the container at AI services on the host, host networking on Linux, an agent program inside the image, pinning a version, and running maintenance scripts inside the container.
Server
Run from sourceRunning the server with Node: clone or download a release, one setup command for the key, content pack, memory model and build, the setup code and the guided setup, running for the LAN, and keeping it running as a service.
Server
First run, accounts and sign-upsThe first account is the administrator and needs the setup code, the guided setup, the three sign-up modes, who may start campaigns and spend paid AI, account invite codes, room codes as invitations, promoting admins, resetting passwords, Discord sign-in, upload budgets, the deletion grace period, and reports.
Server
Settings and adminWhere a setting can be set and which one wins, the admin panel's tabs and sections, the Test backend probe, and the reference table of every environment variable the server reads.
Server
Content pack and world packsThe Open5e content pack that supplies spells, items, monsters and feats, what happens without it, the bundled SRD data, homebrew, world packs that reskin the rules to a universe, the registry, and the licences behind all of it.
ServerDesktop appAndroid app
Art, narration and speech servicesSetting up the optional services: ComfyUI, an OpenAI-compatible image model or the FLUX worker for pictures, Kokoro or another speech server for narration, Whisper for push-to-talk, transcription and dictation, the sound library, and the shared media queue.
Server
Voice chat setupTurning voice on for a self-hosted server: the two transports, the HTTPS requirement, the media port, the announced address behind NAT or Docker, a voice domain and Cloudflare, the STUN and TURN broker for mesh, and the rules you can switch on per campaign.
Server
Reverse proxy and HTTPSPutting the web port behind a certificate with Caddy or nginx, the public URL and secure cookie settings, what needs proxying and what must not be, Cloudflare and tunnels, and the apps' cross-origin calls.
Server
Backups and restoreVerified backups from the admin panel or the command line, what an archive contains and why it is a secret, dry-run and live restores, manual copies, per-item exports, and the one thing you cannot recover without: the encryption key.
ServerDesktop appAndroid app
Updating the serverMoving a Docker or source install to a newer release, what changes on start, how the apps relate to the server version, reading the release notes, and rolling back.
Server
Agent programs and connected agentsTwo ways an agent meets the table on a self-hosted server: an agent program (Claude Code, Codex, opencode, Grok Build) as the storyteller under Admin, and a player's own MCP client acting as them through Settings, Connected agents.
ServerDesktop app
Troubleshooting the serverThe Dungeon Master that narrates fights without rolling, repeats itself, or takes minutes; missing content; missing pictures; voice that connects to silence; players who cannot reach the server; a lost key; and where to read the logs.
Server