# All Things Linux

> All Things Linux is a 501(c)(3) non-profit organization with a mission to empower the Linux ecosystem through education, collaboration, and support.

## Docs

- [Code blocks](https://docs.allthingslinux.org/authoring/code.md): Code fences, titles, line highlights, and language tags for examples in MDX
- [Images and embeds](https://docs.allthingslinux.org/authoring/images.md): Images, videos, frames, and responsive embeds in Mintlify MDX
- [Markdown syntax](https://docs.allthingslinux.org/authoring/markdown.md): MDX basics: headings, lists, links, and Mintlify components on documentation pages
- [Navigation](https://docs.allthingslinux.org/authoring/navigation.md): Define tabs or dropdowns, groups, and page order in docs.json so readers can browse guides and API reference
- [Reusable snippets](https://docs.allthingslinux.org/authoring/reusable-snippets.md): Import shared MDX snippets from the snippets directory for consistent content
- [Global Settings](https://docs.allthingslinux.org/authoring/settings.md): Use docs.json to set theme, colors, logo, navigation tabs, SEO, and API settings for this site
- [Brand](https://docs.allthingslinux.org/brand/index.md): All Things Linux brand guidelines—visual identity, voice and tone, messaging framework, terminology, and the ATL sub-brand system
- [Data Model](https://docs.allthingslinux.org/chat/architecture/data-model.md): Persistent data locations, Docker volume mounts, and the data/ directory structure for the atl.chat platform.
- [Architecture Overview](https://docs.allthingslinux.org/chat/architecture/index.md): System diagram, service topology, and key design decisions for the atl.chat platform.
- [Networking](https://docs.allthingslinux.org/chat/architecture/networking.md): Tailscale overlay, complete port registry, DNS zone layout, and firewall rules for atl.chat.
- [Adding a Service](https://docs.allthingslinux.org/chat/development/adding-a-service.md): Step-by-step guide for integrating a new service into the atl.chat monorepo, covering containers, compose, configuration, data, documentation, and tests.
- [Contributing](https://docs.allthingslinux.org/chat/development/contributing.md): PR workflow, commit conventions, pre-commit hooks, and language-specific code style guides for atl.chat contributors.
- [Testing](https://docs.allthingslinux.org/chat/development/testing.md): Complete guide to the atl.chat test suite — directory layout, running tests, pytest fixtures, mocking patterns, and CI pipeline.
- [Getting Started](https://docs.allthingslinux.org/chat/getting-started/index.md): Prerequisites, install commands, and monorepo orientation for running atl.chat locally.
- [Local Development](https://docs.allthingslinux.org/chat/getting-started/local-development.md): Full walkthrough for bringing up the atl.chat stack on your local machine.
- [atl.chat](https://docs.allthingslinux.org/chat/index.md): Unified IRC, XMPP, web clients, and Discord↔IRC↔XMPP bridges for All Things Linux—Docker, Just, Apache 2.0
- [Backups](https://docs.allthingslinux.org/chat/operations/backups.md): Per-service backup and restore procedures for all atl.chat stateful services.
- [Deployment](https://docs.allthingslinux.org/chat/operations/deployment.md): Complete production deployment runbook covering server topology, Tailscale networking, Docker Compose configuration, and rollback procedures.
- [Monitoring](https://docs.allthingslinux.org/chat/operations/monitoring.md): Health checks, log inspection, metrics collection, and alerting for atl.chat services.
- [Security](https://docs.allthingslinux.org/chat/operations/security.md): Secret management, credential rotation, Docker network isolation, TLS best practices, and Gitleaks pre-commit hook configuration for the atl.chat stack.
- [SSL/TLS](https://docs.allthingslinux.org/chat/operations/ssl-tls.md): Certificate management with cert-manager (Lego), Let's Encrypt, DNS-01 challenges, and per-service certificate paths.
- [Troubleshooting](https://docs.allthingslinux.org/chat/operations/troubleshooting.md): Cross-service diagnostic commands, common issues, and resolution steps for the atl.chat stack.
- [API Reference](https://docs.allthingslinux.org/chat/reference/api.md): JSON-RPC and REST API reference for atl.chat services and the Portal integration.
- [Environment Variables](https://docs.allthingslinux.org/chat/reference/environment-variables.md): Environment variables for Compose, prepare-config templates, Prosody (prosody.cfg.lua), bridge, and apps — cross-checked with .env.example, .env.dev.example, and service configs.
- [FAQ](https://docs.allthingslinux.org/chat/reference/faq.md): Frequently asked questions about atl.chat, connecting to services, contributing, and day-to-day operations.
- [Glossary](https://docs.allthingslinux.org/chat/reference/glossary.md): Definitions of project-specific terms, acronyms, and service names used across the atl.chat documentation.
- [Port Registry](https://docs.allthingslinux.org/chat/reference/ports.md): Complete port registry for all atl.chat services, verified against compose files.
- [Atheme Configuration](https://docs.allthingslinux.org/chat/services/atheme/configuration.md): Config template, environment variables, module system, SASL setup, service bot identities, and general settings for Atheme IRC services.
- [Atheme IRC Services](https://docs.allthingslinux.org/chat/services/atheme/index.md): Overview of Atheme IRC services — NickServ, ChanServ, OperServ, MemoServ, HostServ, and other service bots in the atl.chat stack.
- [Bridge Configuration](https://docs.allthingslinux.org/chat/services/bridge/configuration.md): config.yaml format and channel mapping for the atl.chat bridge.
- [Bridge Overview](https://docs.allthingslinux.org/chat/services/bridge/index.md): Event bus and adapter architecture of the atl.chat Discord↔IRC↔XMPP bridge.
- [Bridge Operations](https://docs.allthingslinux.org/chat/services/bridge/operations.md): Health monitoring, adapter debugging, and Portal identity management for the bridge.
- [IRC Configuration](https://docs.allthingslinux.org/chat/services/irc/configuration.md): Environment variables, config templates, and secrets for the UnrealIRCd and Atheme IRC stack.
- [IRC Stack Overview](https://docs.allthingslinux.org/chat/services/irc/index.md): Overview of the atl.chat IRC stack — UnrealIRCd server and Atheme IRC services.
- [IRC Modules](https://docs.allthingslinux.org/chat/services/irc/modules.md): Managing third-party UnrealIRCd modules with third-party-modules.list and manage-modules.sh.
- [IRC Operations](https://docs.allthingslinux.org/chat/services/irc/operations.md): Oper setup, Atheme bootstrap, config reload, and SSL certificate management for the IRC stack.
- [The Lounge](https://docs.allthingslinux.org/chat/services/thelounge/index.md): Overview of The Lounge web IRC client — private mode, WebIRC integration, and always-on connectivity in the atl.chat stack.
- [Web App Overview](https://docs.allthingslinux.org/chat/services/web/index.md): Overview of the atl.chat public-facing Next.js landing site deployed to Cloudflare Pages.
- [XMPP Configuration](https://docs.allthingslinux.org/chat/services/xmpp/configuration.md): Complete guide to Prosody's prosody.cfg.lua structure, environment variables, VirtualHost blocks, components, and security settings.
- [XMPP Overview](https://docs.allthingslinux.org/chat/services/xmpp/index.md): Overview of the atl.chat XMPP stack powered by Prosody.
- [XMPP Modules](https://docs.allthingslinux.org/chat/services/xmpp/modules.md): Managing Prosody modules — source directory, enabled directory, and community modules.
- [Community](https://docs.allthingslinux.org/community/index.md): How the ATL community runs—Discord guidelines, moderation, events, partnerships, and support workflows
- [atl.dev](https://docs.allthingslinux.org/dev/index.md): ATL developer platform and related apps—FOSS hosting direction plus ISO search (iso.atl.dev) and project sites
- [Claude Code setup](https://docs.allthingslinux.org/developers/ai-tools/claude-code.md): Use Claude Code to draft and review documentation in the monorepo
- [Cursor setup](https://docs.allthingslinux.org/developers/ai-tools/cursor.md): Use Cursor with this repo: rules, MDX editing, and Mintlify preview workflows
- [Windsurf setup](https://docs.allthingslinux.org/developers/ai-tools/windsurf.md): Use Windsurf Cascade with workspace rules for Mintlify MDX and docs.json
- [Create Plant](https://docs.allthingslinux.org/developers/api-reference/endpoint/create.md): Create a plant in the sample Plant Store API (OpenAPI playground demo)
- [Delete Plant](https://docs.allthingslinux.org/developers/api-reference/endpoint/delete.md): Delete a plant by id in the sample Plant Store API (OpenAPI playground demo)
- [Get Plants](https://docs.allthingslinux.org/developers/api-reference/endpoint/get.md): List plants from the sample Plant Store API (OpenAPI playground demo)
- [New Plant](https://docs.allthingslinux.org/developers/api-reference/endpoint/webhook.md): Webhook payload shape for new plants in the sample Plant Store API (demo)
- [Introduction](https://docs.allthingslinux.org/developers/api-reference/introduction.md): How the sample OpenAPI specification powers API reference pages and the interactive playground
- [Governance](https://docs.allthingslinux.org/governance/index.md): How All Things Linux governs itself—bylaws, board of directors, code of conduct, ethics, and decision-making processes
- [Bastion setup](https://docs.allthingslinux.org/network/bastion-setup.md)
- [Coturn](https://docs.allthingslinux.org/network/services/coturn.md)
- [Nginx proxy manager](https://docs.allthingslinux.org/network/services/nginx-proxy-manager.md)
- [Npm irc integration](https://docs.allthingslinux.org/network/services/npm-irc-integration.md)
- [Sftpgo](https://docs.allthingslinux.org/network/services/sftpgo.md)
- [Metrics stack](https://docs.allthingslinux.org/observability/metrics-stack.md)
- [Operations](https://docs.allthingslinux.org/operations/index.md): How ATL runs day-to-day—staff handbook, onboarding, volunteer recruitment, financial operations, and communication norms
- [Organization](https://docs.allthingslinux.org/organization/index.md): All Things Linux as an open organization—mission, values, history, strategy, and how we're structured as a 501(c)(3) non-profit
- [About All Things Linux](https://docs.allthingslinux.org/platform/about.md): Who we are: a volunteer-driven non-profit Linux community, and how this documentation site fits in
- [Contributing](https://docs.allthingslinux.org/platform/contributing.md): How to contribute to All Things Linux docs and the monorepo—for our volunteer-driven 501(c)(3) open-source community
- [Development](https://docs.allthingslinux.org/platform/development.md): Run the Mintlify CLI locally, validate the site, and troubleshoot common issues
- [All Things Linux documentation](https://docs.allthingslinux.org/platform/index.md): Product docs for portal, atl.chat, atl.sh, atl.dev, atl.tools, atl.wiki, and tux—plus organization, governance, community, and developer reference
- [Quickstart](https://docs.allthingslinux.org/platform/quickstart.md): Clone the All Things Linux monorepo and preview this documentation site in a few minutes
- [Policies](https://docs.allthingslinux.org/policies/index.md): All Things Linux legal and operational policies—privacy, terms of service, trademark, inclusion, and data retention
- [portal](https://docs.allthingslinux.org/portal/index.md): Centralized ATL identity—BetterAuth, Drizzle, integrations for email, chat, pubnix, wiki, Discord, and cross-domain services
- [Security](https://docs.allthingslinux.org/security/index.md): ATL security policy, vulnerability disclosure, endpoint security, and infrastructure security practices
- [Admin Guide](https://docs.allthingslinux.org/sh/admin-guide.md): Deployment, infrastructure, and operational reference for atl.sh admins.
- [Architecture](https://docs.allthingslinux.org/sh/architecture.md): Infrastructure, networking, and system design for atl.sh.
- [Code of Conduct](https://docs.allthingslinux.org/sh/code-of-conduct.md): Community standards for atl.sh.
- [Adding a Role](https://docs.allthingslinux.org/sh/development/adding-a-role.md): Step-by-step guide for adding a new Ansible role to atl.sh.
- [Contributing](https://docs.allthingslinux.org/sh/development/contributing.md): How to contribute to atl.sh — PR workflow, code style, and development setup.
- [Development Environment](https://docs.allthingslinux.org/sh/development/index.md): Languages, compilers, package managers, and tools available on atl.sh.
- [Local Development](https://docs.allthingslinux.org/sh/development/testing.md): Test Ansible playbooks locally using Vagrant before deploying to staging or production.
- [Ansible Variables](https://docs.allthingslinux.org/sh/development/variables.md): Complete reference of Ansible variables used across all atl.sh roles.
- [FAQ](https://docs.allthingslinux.org/sh/faq.md): Frequently asked questions about atl.sh.
- [atl.sh](https://docs.allthingslinux.org/sh/index.md): A public Unix environment run by the All Things Linux community.
- [Operations](https://docs.allthingslinux.org/sh/operations/index.md): Monitoring, backups, security hardening, and maintenance for atl.sh admins.
- [Security Deep Dive](https://docs.allthingslinux.org/sh/operations/security.md): CIS hardening, audit rules, user isolation, and the defense-in-depth model on atl.sh.
- [SSL/TLS & Certificates](https://docs.allthingslinux.org/sh/operations/ssl-tls.md): Certificate management, renewal, and TLS configuration across atl.sh services.
- [Troubleshooting](https://docs.allthingslinux.org/sh/operations/troubleshooting.md): Diagnostic commands, common issues, and resolution steps for atl.sh.
- [Publishing](https://docs.allthingslinux.org/sh/publishing.md): Host websites, Gemini capsules, Gopher holes, and CGI scripts on atl.sh.
- [Glossary](https://docs.allthingslinux.org/sh/reference/glossary.md): Definitions of terms used throughout the atl.sh documentation.
- [Resource Limits](https://docs.allthingslinux.org/sh/resources.md): Disk quotas, CPU and memory limits, and process isolation on atl.sh.
- [Finger (efingerd)](https://docs.allthingslinux.org/sh/services/finger.md): Finger protocol via efingerd with socket activation and custom scripts.
- [FTP (vsftpd)](https://docs.allthingslinux.org/sh/services/ftp.md): Explicit FTP over TLS with vsftpd for file uploads.
- [Gemini (molly-brown)](https://docs.allthingslinux.org/sh/services/gemini.md): Gemini capsule hosting with molly-brown, TLS certificates, and the reversed symlink architecture.
- [Gopher (Gophernicus)](https://docs.allthingslinux.org/sh/services/gopher.md): Gopher hole hosting with Gophernicus, gophermap format, and socket activation.
- [Nginx (Web)](https://docs.allthingslinux.org/sh/services/nginx.md): Tilde site hosting, CGI scripts, and webring injection via nginx.
- [User Guide](https://docs.allthingslinux.org/sh/user-guide.md): Everything you need to know to get started on atl.sh.
- [Webring](https://docs.allthingslinux.org/sh/webring.md): Join the ATL Webring to connect your personal site to the community.
- [atl.tools](https://docs.allthingslinux.org/tools/index.md): Curated directory of free self-hosted tools—PrivateBin, SearXNG, CyberChef, and more at *.atl.tools
- [tux](https://docs.allthingslinux.org/tux/index.md): All-in-one open source Discord bot—moderation, leveling, snippets, plugins; Python, discord.py, docs at tux.atl.dev
- [atl.wiki](https://docs.allthingslinux.org/wiki/index.md): MediaWiki at atl.wiki—Docker deployment configs, MariaDB, S3/R2, Citizen skin; operator-focused repo

## OpenAPI Specs

- [openapi](https://docs.allthingslinux.org/developers/api-reference/openapi.json)

## Optional

- [Website](https://allthingslinux.org)
- [GitHub](https://github.com/allthingslinux)
- [Discord](https://discord.gg/linux)
- [Open Collective](https://opencollective.com/allthingslinux)