Skip to content

Guide overview

This documentation describes the code currently present in this independent Lag fork. It separates implemented behavior from integration patterns or future work.

What runs

The default build is one container with a web gateway, Fastify API, PostgreSQL, and LiveKit. 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

  1. Configuration for runtime values and safe defaults.
  2. Authentication and permissions before exposing an instance.
  3. Deployment and networking for TLS, firewall, NAT, and reverse proxies.
  4. Operations for backups, health checks, upgrades, and troubleshooting.
  5. 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.

Independent fork documentation. Not an upstream Lag service.