Pi-hole DoT/DoH

Pi-hole DoT/DoH is a containerized Pi-hole DNS server with built-in DNS over TLS and DNS over HTTPS support, letting homelab users encrypt DNS queries for…

  • Network Services
  • Other
  • Security
Pi-hole DoT/DoH is a containerized Pi-hole DNS server with built-in DNS over TLS and DNS over HTTPS support, letting homelab users encrypt DNS queries for local or remote devices while keeping network-wide ad and tracker blocking.

Platform availability

Available on 1 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

61/100 Good

Maintained
84last commit 28 days ago
Popular
3133 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
85512 MB minimum RAM

Availability: platform listings confirmed today

GitHub stars
33
Open issues
2
Last commit
2026-10-24
License
GPL-3.0
Activity
rising

Checked 15 days ago - source: GitHub (devzwf/pihole-dot-doh)

Resources & Compatibility

Minimum requirements: 512 MB RAM, 2 GB disk. ARM (e.g. Raspberry Pi) is not supported.

Checked 15 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Install the Python package first Make sure pihole6api is installed with pip (the Python package installer) by running pip install pihole6api. Without it, this tool has no bridge to Pi-hole and setup fails. source
  • Point it at your Pi-hole with a password Enter your Pi-hole web address, for example https://pi.hole/, and the Pi-hole API password (the password Pi-hole uses for its admin API). If either is missing or wrong, the app cannot load settings, lists, or network information. source
  • Built for Pi-hole 6 Use Pi-hole 6, because this package is made for that version. On older Pi-hole versions, some calls may fail or return hard-to-understand errors. source
  • Static IP and DNS variables Assign a static IP to the container and set both DNS1 and DNS2 to 127.1.1.1#5153 for DoH, 127.2.2.2#5253 for DoT, or the same value for one mode; Unraid DNS settings should not point to the container IP. source
  • Upgrading from v5 Pi-hole v6 is a ground-up redesign with breaking changes vs v5: environment variable names changed and v5 volume configs get replaced irreversibly. Read the README before upgrading. source
  • Pi-hole v6 breaking changes Pi-hole v6 is a ground-up redesign: environment variable names and script locations changed, and swapping a v5 image for v6 rewrites your saved configuration irreversibly. Read the Docker docs before upgrading. source

Fetched 2 days ago - each note links to its source

Alternatives (12)

  • AdAway - An ad blocker that uses the hosts file.
  • AdGuard - AdGuard is the best way to get rid of intrusive ads and online tracking, and to protect your computer from malware.
  • AdGuard Home - AdGuard Home is a self-hosted DNS server that blocks ads and trackers across your entire home network by re-routing tracking domains to a b…
  • Blokada - Blokada is the popular ad blocker and privacy app for Android and iOS.
  • Control D - Control D is a modern and customizable DNS service that blocks threats, unwanted content and ads - on all devices.
  • JustDNS - JustDNS is a self-hosted filtering DNS resolver for your whole network.
  • NextDNS - NextDNS protects you from all kinds of security threats, blocks ads and trackers on websites and in apps and provides a safe and supervised…
  • Numa - Portable DNS resolver in a single binary.
  • Portmaster - Free and open-source tool that monitors all network activity, blocks unwanted connections, uses filter lists for ads and malware, enforces…
  • Privoxy - Privoxy is a non-caching web proxy with advanced filtering capabilities for enhancing privacy, modifying web page data and HTTP headers, co…
  • RethinkDNS - An OpenSnitch-inspired firewall and network monitor + a pi-hole-inspired DNS over HTTPS client with blocklists.
  • Technitium DNS Server - Technitium DNS Server is an open source tool that can be used as a personal local DNS server for privacy & security.

Checked 15 days ago - source: AlternativeTo

Common questions

What Docker networking constraints affect Pi-Hole DoH/DoT?

You must assign a static IP address to the Docker container for Pi-hole to work. Port 53 can only be used with a custom br0/br1 network and a static IP, and DNS lookup rarely works on other ports. On Unraid, the network DNS server setting cannot point to the Docker IP.

How should DNS1 and DNS2 be set for DoH and DoT?

Set both DNS1 and DNS2 to 127.1.1.1#5153 for DoH and/or 127.2.2.2#5253 for DoT. If you want only DoH or only DoT, set both variables to the same value.

Why do self-hosters look for a DoH/DoT Pi-hole container?

A common complaint was that stock Pi-hole did not natively support secure DNS protocols such as DoH and DoT, inbound or upstream.

Does Pi-hole remain effective if clients use encrypted DNS elsewhere?

The discussion questions whether Pi-hole's blocklists remain useful if it does not see the DNS records being queried. That can happen when clients use DoH or DoT to another resolver.

Answers sourced from www.reddit.com, www.reddit.com, www.reddit.com, www.reddit.com

Community

No community discussions collected yet.