← sources

MazeDNS: a multi-site alternative to Pi-hole/AdGuard Home

source: reddit (reddit:selfhosted)published 2026-10-27 21:56ingested 2026-10-28 02:37

retained text

Hi r/selfhosted,

we're two homelabbers (day jobs in cybersecurity/infrastructure) and we've been building **MazeDNS**, a self-hosted filtering DNS resolver in the spirit of Pi-hole and AdGuard Home, designed for people who run DNS in more than one place. It's part of **Maze Labs**, a small set of self-hosted tools we make for our own homelabs: [https://amaze-labs.github.io/](https://amaze-labs.github.io/)

**AI disclosure:** we build MazeDNS with AI coding assistants. We design it, review every change and test each release in our own labs, and it's all AGPL-3.0 so you can read the code.

**Why another DNS filter?** Pi-hole/AdGuard Home are great on a single box. We wanted one dashboard and one config for several sites without syncing instances by hand.

**How it works**

* One **control plane** (web UI + API, no DNS) and one or more **agents** (the DNS part) placed near your clients
* Agents enroll with a key, copy the config, and keep answering from their last copy if the control plane is down
* Sites, roles, maintenance/drain mode, health and sync status per agent

**Features**

* Blocklists (URL/file/pasted), allow/deny rules, whole-category blocking, one-click pause
* Local records, conditional forwarding, split-horizon per site/agent
* DoT/DoH (server and upstream), DNSSEC-transparent forwarding, cache, per-client rate limits
* Per-device query breakdown with traffic types (social, streaming, work…)
* Domain risk scoring from sources you choose (threat feeds, WHOIS age, name shape, optional LLM)
* Local users or OIDC SSO, API tokens, Prometheus `/metrics`, optional VictoriaMetrics/VictoriaLogs

**Deploy:** two containers, Docker Compose or Kubernetes. Quick start is in the README: [https://github.com/amaze-labs/MazeDNS](https://github.com/amaze-labs/MazeDNS)

**Honest limitations**

* Young project, small user base
* The resolver has no client ACL: keep agents on a private network, never expose :53
* Don't expose the control plane to the internet (VPN/reverse proxy only)

Docs: install, user guide, configuration, troubleshooting are all in the repo.

We'd love feedback, especially on multi-site setups and anything that breaks. Thanks!

document fetched 2026-10-28 00:30 · canonical https://reddit.com/r/selfhosted/comments/1xh63jb/mazedns_a_multisite_alternative_to_piholeadguard