Project · Aug 2025
Pi-hole with Docker on Raspberry Pi
AI Summary
Pi-hole was deployed as a network-wide DNS sinkhole on a Raspberry Pi 3B using Docker, blocking ads and trackers for every device on the local network without any per-device configuration. Pi-hole works by intercepting DNS queries and dropping requests to known ad and malware domains before they resolve — covering browsers, apps, and smart devices that browser extensions can't reach. Docker Compose was used to define and manage the container, with DNS (port 53), HTTP (80), and HTTPS (443) exposed and persistent storage configured so blocklists and settings survive restarts.
Effectiveness was measured using an ad-blocking test across three configurations: router only scored 38/100, adding Pi-hole brought that to 69/100, and combining Pi-hole with a browser extension pushed it to 77/100. The results demonstrate that DNS-level blocking provides meaningful coverage on its own and stacks well with browser-based filtering.
The project built practical skills in Docker, DNS architecture, Linux system administration, and writing clear technical documentation — all running on consumer hardware headlessly managed via Pi-Connect.