pi-hole/ftl — explained in plain English
Analysis updated 2026-07-25 · repo last pushed 2026-07-25
Run Pi-hole on a Raspberry Pi to block ads across all devices on your home network.
Block ads on devices that can't install their own ad blockers, like smart TVs and older tablets.
Track and view statistics on which domains and ads were blocked via an interactive API.
| pi-hole/ftl | peng-zhihui/peak | vercel-labs/zero | |
|---|---|---|---|
| Stars | 1,680 | 1,829 | 1,465 |
| Language | C | C | C |
| Last pushed | 2026-07-25 | 2022-12-12 | — |
| Maintenance | Active | Dormant | — |
| Setup difficulty | moderate | hard | moderate |
| Complexity | 3/5 | 4/5 | 4/5 |
| Audience | ops devops | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Replaces dnsmasq entirely, so it will disable any existing dnsmasq installation already running on your machine.
Pi-hole is a popular tool that blocks ads across every device on your home or office network, phones, laptops, smart TVs, everything, without needing to install separate ad blockers on each one. FTLDNS is the engine that makes it all work behind the scenes, handling the actual DNS requests (the lookup step that happens whenever a device tries to reach a website) and generating the statistics you see in the dashboard. At a high level, it works by intercepting every request a device makes to load a website. If the requested domain is on a blocklist, the request is denied before it ever leaves your network. What makes this engine special is that it's built directly on top of an existing, well-tested DNS tool called dnsmasq, rather than being written from scratch. This means it can inherit all the reliability of that mature tool while adding the extra features Pi-hole needs, like tracking which sites were blocked and serving up that data through an interactive API. The primary audience is anyone running Pi-hole on a Linux machine or a small device like a Raspberry Pi. If you've ever wanted to block ads on your smart TV, your phone, or an older tablet that can't run its own ad blocker, this is the layer that makes that possible. It's designed to be lightweight enough to run on minimal hardware, including the tiny Raspberry Pi Zero. One important tradeoff to be aware of: because this engine essentially replaces dnsmasq, it will disable any existing copy of that tool already running on your machine. The two can't coexist. For most people this won't matter, but if you're already using dnsmasq for something else on the same device, you'll need to plan around that.
The engine behind Pi-hole that blocks ads network-wide by intercepting DNS requests, built on top of dnsmasq, and provides dashboard statistics through an interactive API.
Mainly C. The stack also includes C, dnsmasq, Linux.
Active — commit in last 30 days (last push 2026-07-25).
No license information was provided in the explanation.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly ops devops.
This repo across BitVibe Labs
double-check against the repo, no cap.