LibreAI / Self-Hosted / Pi-hole
// selfhosted · pi-hole/pi-hole

Pi-hole

Pi-hole — a black hole for internet advertisements: network-wide ad and tracker blocking at the DNS level, for every device in the house, from one small box

★ 61.3k stars⑂ 3.3k forksCustom (check repo)updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Pi-hole is an open-source self-hosted project by pi-hole (pi-hole/pi-hole on GitHub). It has 61,305 GitHub stars and 3,323 forks, is released under the Custom (check repo) license, and was last updated on GitHub on 17 October 2026.

Repository
pi-hole/pi-hole
GitHub stars
61,305
Forks
3,323
License
Custom (check repo)
Last updated on GitHub
17 October 2026
Category
Self-Hosted
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Install Pi-hole

    On a Raspberry Pi or any Debian/Ubuntu-class machine, run the one-step installer from the README: curl -sSL https://install.pi-hole.net | bash.

  2. Point your network at it

    Set Pi-hole as the DNS server in your router (or enable its built-in DHCP), so every device starts resolving through it.

  3. Tune from the dashboard

    Open the admin interface to watch blocked queries, add blocklists, and whitelist anything a service you use actually needs.

// features

Why people love it

Network-wide blocking

Ads and trackers blocked at DNS level for every device — phones, TVs and IoT gadgets included, no per-device installs.

Real visibility

A live dashboard of DNS queries, top domains and per-client activity across your whole network.

Blocklist ecosystem

Ships with sensible defaults and supports the large community-maintained blocklist ecosystem, plus per-client group rules.

Runs on almost nothing

Built for a Raspberry Pi; equally happy in a Docker container or a tiny VM.

Advertisement
// run it

Run it yourself

  1. One-step install

    The README automated install on a supported OS.

    curl -sSL https://install.pi-hole.net | bash
  2. Manual install

    Clone and run the installer yourself, per the README.

    git clone --depth 1 https://github.com/pi-hole/pi-hole.git Pi-hole
    cd "Pi-hole/automated install/"
    sudo bash basic-install.sh
  3. Docker alternative

    Pi-hole also publishes an official container image (pihole/pihole) if you prefer containers to a bare-metal install.

    docker run -d --name pihole -p 53:53/tcp -p 53:53/udp -p 80:80 pihole/pihole:latest
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who makes Pi-hole?

The Pi-hole community project (pi-hole/pi-hole on GitHub), maintained by a volunteer team.

Is Pi-hole free?

Yes, free and open source — check the repository for the exact licence terms. Donations keep the project going.

Will it break websites?

Occasionally a site needs a domain that blocklists catch; the dashboard shows exactly what was blocked and whitelisting takes seconds.

How does it compare to a well-known alternative?

Against a browser ad-blocker like uBlock Origin, Pi-hole is broader (every device, not just one browser) but coarser — it cannot hide page elements or block in-video ads served from the same domain. Against AdGuard Home, its closest rival, Pi-hole has the larger community and blocklist ecosystem; AdGuard Home counters with built-in encrypted-DNS upstreams.

How do I get started?

curl -sSL https://install.pi-hole.net | bash on a Pi or Linux box, then set it as your router DNS server.

// keep exploring

Similar tools

Self-Hosted

homebutler

Know what changed on your servers — one Go binary, no database.

★ 298 starsMIT
View guide →
Self-Hosted

marketingdashboard

A one-screen real-time market research cockpit for stocks and more.

★ 341 starsMIT
View guide →
Self-Hosted

shortlist

Private recommendation rows for every Plex user, from their own history.

★ 93 starsMIT
View guide →
Self-Hosted

Uptime Kuma

Uptime Kuma — a fancy self-hosted monitoring tool: uptime checks for sites and services every 20 seconds, with a beautiful status page and 90+ alert channels

★ 92.6k starsMIT
View guide →
Self-Hosted

LinkStack

LinkStack - the ultimate solution for creating a personalized & professional profile page. Showcase all your important links in one place, forget the limitat…

★ 3.9k starsAGPL-3.0
View guide →
Self-Hosted

huntly

Your personal AI-powered information hub: RSS, Pocket, and social in one.

★ 2.3k starsApache-2.0
View guide →
// alternatives

Alternatives in Self-Hosted

The most-starred other Self-Hosted projects in the LibreAI catalogue — the realistic shortlist if Pi-hole is not the right fit.

Get Pi-hole

Free and open — grab the source, star the repo, and start creating.