Guide overview
Lag is a self-hosted voice and chat server: voice rooms, persistent text chat, room roles, and an administration console, delivered as one container with a web UI, Fastify API, PostgreSQL, and LiveKit behind it. This site documents the code currently present in this repository and separates implemented behavior from integration patterns or future work.
What runs
Users authenticate through one configured Prism/OIDC/OAuth provider (or optional nickname guest mode), use role-aware rooms, exchange persistent text messages, and connect to voice. Start with architecture and context before changing topology.
Suggested reading
- Deployment tutorial, a step-by-step path from an empty host to a verified instance.
- Configuration for runtime values and safe defaults.
- Authentication and permissions before exposing an instance.
- Operations for backups, health checks, upgrades, and troubleshooting.
- Development for source builds and validation.
Production warning
The Compose defaults devkey and secret are insecure, and its identity-provider values are development examples. Configure real authentication and secrets before internet exposure; enable nickname guests only deliberately.