selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Pi-hole logo

Self-host Pi-hole

v6.6

Network-wide DNS ad blocker for your entire network

ReleaseOpen SourceOther
Updated3 days ago
LanguageShell
Setup difficultyModerate
MobileResponsive
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))
Docker
pihole/pihole
Install with Docker

What 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

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

Pi-hole website
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

How to install Pi-hole

Install Pi-hole with Docker

Docker and Docker Compose; NET_ADMIN and SYS_TIME capabilities for DHCP/NTP

docker compose up -d

services:
  pihole:
    container_name: pihole
    image: pihole/pihole:latest
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "80:80/tcp"
      - "443:443/tcp"
    environment:
      TZ: 'Europe/London'
      FTLCONF_webserver_api_password: 'correct horse battery staple'
      FTLCONF_dns_listeningMode: 'ALL'
    volumes:
      - './etc-pihole:/etc/pihole'
    cap_add:
      - NET_ADMIN
      - SYS_TIME
      - SYS_NICE
    restart: unless-stopped

Official Docker image from pihole/pihole on Docker Hub

Pi-hole releases & version history

@ Every self-hosted release, weekly

One Monday email with the week's stable releases across the directory.

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

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…