Project · Aug 2025

Pi-hole with Docker on Raspberry Pi

Raspberry Pi Docker Pi-hole DNS Networking Linux

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.

← Back to Projects View full project on GitHub →