atl.chat Documentation
Unified chat infrastructure combining IRC, XMPP, Discord, and a web interface.
atl.chat documentation covers everything you need to deploy, operate, and contribute to a self-hosted unified chat platform that bridges IRC, XMPP, and Discord into a single community experience.
What is atl.chat?
atl.chat is an open-source monorepo that provides unified chat infrastructure for the All Things Linux community. It combines an IRC server (UnrealIRCd 6.x with Atheme services), an XMPP server (Prosody), a Discord↔IRC↔XMPP bridge, web IRC clients (The Lounge, Gamja), an admin panel (WebPanel), and a Next.js web application — all orchestrated with Docker Compose and managed through the just task runner.
The project lets community members participate from whichever protocol they prefer while keeping conversations synchronised across all platforms.
Project status
Note: atl.chat is currently v0.1.0 alpha and not yet production-ready. APIs and configuration formats may change without notice.
Choose your path
Pick the path that matches your role to find the most relevant documentation.
Developer / Contributor
If you want to build features, fix bugs, or extend the platform:
- Getting Started — install prerequisites and spin up the local dev stack
- Architecture — understand the system design, networking, and data model
- Development — learn the PR workflow, code style, and testing practices
- Services — dive into individual service internals
Operator / Sys Admin
If you want to deploy, configure, and maintain the stack in production:
- Getting Started — install prerequisites and verify your environment
- Operations — production deployment, SSL/TLS, backups, monitoring, and security
- Services — per-service configuration and operational guides
- Reference — environment variables, ports, and API reference
Quick links
- Getting Started — prerequisites, local development setup, and first-run guide
- Architecture — system diagram, design decisions, networking, and data model
- Services — deep dives into IRC, Atheme, XMPP, Bridge, Web, The Lounge, and WebPanel
- Operations — deployment, SSL/TLS, backups, monitoring, troubleshooting, and security
- Development — contributing guide, testing, and adding new services
- Reference — environment variables, ports, API reference, glossary, and FAQ