Self-host Pi-hole
v6.6Network-wide DNS ad blocker for your entire network
- Stars
- 62 016
- RAM
- 512MB
- Storage
- 2GB free space (4GB recommended)
- Ports
- 53 (DNS (TCP/UDP)), 67 (DHCP (IPv4 UDP)), 547 (DHCPv6 (IPv6 UDP)), 80 (HTTP (Web Interface)), 443 (HTTPS (Web Interface)), 123 (NTP (UDP))
pihole/piholeWhat is Pi-hole?
Pi-hole is a network-wide ad blocker that works as a DNS sinkhole, preventing advertisements and trackers from reaching any device on your network without requiring software on each device. It runs on Linux hardware such as Raspberry Pi, old computers, virtual machines, and NAS units. The software offers both a command-line interface and an optional web dashboard for viewing statistics, managing blocklists, and adjusting settings. It can also serve as a DHCP server and handles both IPv4 and IPv6 traffic. A REST API enables automation and integration with home automation systems. You can install it through a one-step automated installer, Docker containers, or manually on supported Linux distributions. The minimum hardware needs are 512MB of RAM and 2GB of free disk space.
Pi-hole alternatives
RaspAPOpen-source, self-hosted wireless router and access point web interface for Debian-based devices like the Raspberry Pi, adding VPN, ad blocking and DHCP control.CompareRaspAP with Pi-hole
blockyFast and lightweight DNS proxy as ad-blocker for local network with many featuresCompareblocky with Pi-hole
Maza ad blockingOpen-source, self-hosted local ad blocker written only in Bash: one command rebuilds your hosts file to block ad domains, no browser extensions needed.CompareMaza ad blocking with Pi-hole
PiVPNSelf-hosted shell-script installer turning a Raspberry Pi or x86_64 Debian/Ubuntu server into a hardened WireGuard or OpenVPN VPN server, managed via the pivpn CLI.ComparePiVPN with Pi-hole
docker-adguardMinimal, security-hardened Docker image for self-hosted AdGuard Home ad blocking. Runs rootless, distroless from scratch, with health checks and CVE scanning.Comparedocker-adguard with Pi-hole
cactusdcactusd is an open-source, self-hosted daemon that aggregates and serves domain/IP blocklists for DNS-based ad-blocking, updating every 12 hours with a built-in web UI.Comparecactusd with Pi-hole
ublproxySelf-hosted HTTPS proxy blocking ads at the HTTP layer with Adblock Plus/uBlock Origin syntax, scriptlets, cosmetic filtering, and passkey auth.Compareublproxy with Pi-hole
super📡 SPR: Open Source, secure, user friendly and fast wifi routers for your home. One wifi password per device. Ad Blocking & Privacy Blocklists. Policy Based Network AccessComparesuper with Pi-hole
Should you self-host Pi-hole?
Pi-hole scores 88/100 on selfhost.directory (how scoring works) and ranks #1 of 41 in DNS. It has 62 016 GitHub stars, +774 in the last 30 days.
It shipped 7 stable releases in the past year. The latest, v6.6, came out on 11 November 2026. New versions land roughly every 2 months.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is Other-licensed and written mostly in Shell.
Its closest alternative on selfhost.directory is AdGuard Home (85/100, 38 471 stars). Pi-hole scores higher overall. See Pi-hole vs AdGuard Home side by side.
Features
- Built-in DHCP serverOptional feature
- Command Line Interface
- DNS Caching
- Group Management
- IPv4 and IPv6 Support
- Long Term Statistics
- Network-wide ad blocking
- NTP ServerOptional feature
- Privacy Modes
- Regex blocking
- REST API
- Teleporter backup/restore
- Web Dashboard
Pi-hole README
Network-wide ad blocking via your own Linux hardware
The Pi-hole® is a DNS sinkhole that protects your devices from unwanted content without installing any client-side software.
- Easy-to-install: our dialogs walk you through the simple installation process in less than ten minutes
- Resolute: content is blocked in non-browser locations, such as ad-laden mobile apps and smart TVs
- Responsive: seamlessly speeds up the feel of everyday browsing by caching DNS queries
- Lightweight: runs smoothly with minimal hardware and software requirements
- Robust: a command-line interface that is quality assured for interoperability
- Insightful: a beautiful responsive Web Interface dashboard to view and control your Pi-hole
- Versatile: can optionally function as a DHCP server, ensuring all your devices are protected automatically
- Scalable: capable of handling hundreds of millions of queries when installed on server-grade hardware
- Modern: blocks ads over both IPv4 and IPv6
- Free: open source software that helps ensure you are the sole person in control of your privacy
FAQ
In which order are locally defined DNS records used?
Order: 1) Device hostname and pi.hole, 2) Config files in /etc/dnsmasq.d/, 3) /etc/hosts, 4) Local (custom) DNS list in /etc/pihole/custom.list. Only the first match triggers.
Why does Pi-hole's gravity complain about invalid IDN domains?
DNS servers only store Punycode representations of internationalized domain names, not the Unicode characters. Ask the list maintainer to convert IDNs to Punycode.
Pi-hole update fails due to repository changed its 'Suite' value - how to fix?
Run `sudo apt-get update --allow-releaseinfo-change` to accept the repository suite change after a major OS upgrade.
Why do I see odd random character queries in Pi-hole's query logs?
These are Chrome's intranet redirect detector queries - Chrome generates random domain names to detect if DNS is being hijacked by wildcard DNS servers.
More in DNS
pihole-doh-wireguardSelf-hosted Docker Compose stack combining Pi-hole ad-blocking, Cloudflared DNS-over-HTTPS encryption, and WireGuard VPN for secure remote access to your home network.
pihole-unbound-dockerSelf-hosted DNS ad-blocking with Pi-hole and Unbound recursive resolver for privacy and security, deployed via Docker Compose.
pihole-unbound-tailscale-dockerizedSelf-hosted Docker Compose project combining Pi-hole ad-blocking, Unbound recursive DNS, and Tailscale VPN for secure remote DNS access behind CGNAT.
pihole-v6-unboundSelf-hosted Docker image running Pi-hole plus an integrated Unbound recursive resolver in one container, published to Docker Hub and GHCR with weekly rebuilds.
poweradminSelf-hosted, open-source web control panel and REST API for PowerDNS: manage zones, records, DNSSEC and users, with LDAP/SSO and Docker deployment.
PowerDNS-AdminOpen-source, self-hosted web interface for administering PowerDNS forward and reverse zones, with role-based access, SAML/LDAP/OAuth sign-in, TOTP 2FA and DynDNS support.
router7Open-source, self-hosted home internet router written in pure Go: DHCPv4/DHCPv6, DNS, port forwarding and auto-rolling-back updates as a gokrazy appliance.
Smart-DNSSelf-hosted Smart DNS service that resolves whitelisted domains to a specified IP while forwarding other queries normally, using a Python DNS server and Nginx SNI proxy.
SPFtoolboxSPFtoolbox is a self-hosted, open-source DNS lookup tool that checks SPF, MX, DMARC, blacklist, WHOIS, and other domain records through a web interface.
Technitium DNS ServerSelf-hosted, open-source authoritative and recursive DNS server with a web console, DNS sinkhole ad blocking, DoH/DoT/DoQ, and a built-in DHCP server.
UnboundSelf-hosted, open-source DNS resolver that validates, recurses and caches, adding DNS-over-TLS, HTTPS and QUIC, RPZ filtering and DNSSEC privacy features.
who-datwho-dat is a self-hosted, open-source WHOIS/RDAP lookup API that normalizes domain data into consistent JSON, with Docker, binary, and Vercel deployment.
0 comments