
Homelab Pihole Dns
This walks you through setting up Pi-hole as a network-wide DNS ad blocker, whether you're running it in Docker or bare metal on a Raspberry Pi. It covers the practical decisions you'll face: pointing your router's DHCP at it versus running Pi-hole as your DHCP server, setting up DNS-over-HTTPS with cloudflared so your ISP can't see your queries, and managing blocklists without breaking legitimate services. The local DNS records section is especially useful if you're tired of remembering IP addresses for your NAS and dashboards. Includes real troubleshooting commands and warns against common mistakes like running a single point of failure for your entire network's DNS.
- skills.sh installs
- 1.6K
- GitHub stars
- 229.1K
- last updated
- Jul 14, 2026
Install
$ npx -y skills add affaan-m/everything-claude-code --skill homelab-pihole-dns --agent claude-codeInstalls into .claude/skills of the current project.
Files
Homelab Pi-hole DNS
Pi-hole is a network-wide DNS ad blocker that runs on a Raspberry Pi or any Linux host. Every device on your network gets ad and malware domain blocking automatically — no browser extension needed.
When to Use
- Installing Pi-hole on a Raspberry Pi or Linux host
- Configuring Pi-hole as the DNS server for a home network
- Adding or managing blocklists
- Setting up DNS-over-HTTPS (DoH) upstream resolvers
- Creating local DNS records (e.g.
nas.home.lan,pi.home.lan) - Troubleshooting devices that lose internet access after Pi-hole is installed
- Running Pi-hole alongside or instead of DHCP
How Pi-hole Works
Normal flow (without Pi-hole):
Device → requests ads.tracker.com → ISP DNS → real IP → ads load
With Pi-hole:
Device → requests ads.tracker.com → Pi-hole DNS → blocked (returns 0.0.0.0) → no ad
All DNS queries go through Pi-hole first.
Pi-hole checks against blocklists.
Blocked domains return a null response — the ad/tracker never loads.
Allowed domains get forwarded to your upstream resolver (Cloudflare, Google, etc.).
Installation
Docker (Recommended)
Sponsors
Details
- Repository
- github.com/affaan-m/everything-claude-code
- First seen
- Jun 3, 2026
More from affaan-m/everything-claude-code
All 256- Homelab Vlan Segmentation1.6K
- Homelab Wireguard Vpn1.6K
- Mle Workflow1.6K
- Motion Foundations1.6K
- Motion Patterns1.6K
- Quarkus Patterns1.6K
- Quarkus Security1.6K
- Quarkus Tdd1.6K
- Quarkus Verification1.6K
- Skill Scout1.6K
- Uspto Database1.6K
- Prisma Patterns1.4K
- Blender Motion State Inspection1.3K
- Recsys Pipeline Architect1.3K
- Uncloud1.2K
- React Testing910
- React Performance903
- React Patterns893
- Frontend A11y870
- Marketing Campaign827
- Benchmark Optimization Loop826
- Latency Critical Systems818
- Parallel Execution Optimizer813
- Social Publisher806