Documentation
Thread your way through.
Guides for installing, starting and configuring Labyrinth DNS. Everything here mirrors the project README — if the two ever disagree, the README wins.
Installation
One-line install script, Docker image, or building from source — plus how to verify the install.
ReadQuick start
From zero to a DNSSEC-validated answer in about two minutes: install, start, dig, dashboard.
ReadConfiguration
labyrinth.yaml end to end — server, resolver, cache, security, web, blocklist — plus CLI flags, environment variables and signals.
ReadWeb dashboard
The built-in dashboard end to end — setup wizard, every page, and JWT authentication.
ReadREST API
The full API surface: stats, cache, blocklist, system, setup and the DoH endpoint.
ReadMonitoring
Prometheus metrics, the two Zabbix integration modes, health checks and logs.
ReadReference
Deeper dives, ported from the original documentation tree.
- ResolutionThe iterative walk, QNAME minimisation, DNSSEC at every step.
- Wire protocolMessage structure, EDNS0, cookies, 0x20, encrypted transports.
- Caching256 shards, TTL policy, serve-stale, aggressive synthesis.
- SecurityPoisoning defenses, abuse controls, CPU-exhaustion closures.
- Daemon modeForeground, daemon, systemd and the signal set.
- BenchmarkThe numbers and how to reproduce them on your hardware.
- Performance tuningMeasure first, then the knobs that matter.
- TroubleshootingFrom symptom to log line, checklist style.
Everything here mirrors the project README — if the two ever disagree, the README wins. The dashboard’s About page renders the RFC compliance matrix.