Homelab Pi-hole DNS

What it does

Provides step-by-step guidance to install, configure, and operate Pi-hole as a network-wide DNS ad blocker for homelab and home networks. Covers Docker and bare-metal installs, setting static IPs, router/DHCP integration, blocklist management, DNS-over-HTTPS with cloudflared, local DNS records, and common troubleshooting commands.

When to use it

Use this skill when setting up Pi-hole on a Raspberry Pi or Linux host, migrating DNS to Pi-hole, adding or auditing blocklists, enabling DoH upstreams for privacy, configuring Pi-hole as DHCP, or diagnosing devices that lose connectivity after Pi-hole deployment.

What's included

• Scripts: No dedicated scripts detected in the repo (has_scripts=false).
• References: No explicit references directory (has_references=false), but the skill body links common upstreams and tools (cloudflared, StevenBlack hosts).
• Instructions: Full procedural notes for Docker and bare-metal installs, composing docker-compose yaml, setting static IP, pointing your router at Pi-hole, blocklist recommendations, cloudflared DoH proxy setup, local DNS record examples, and troubleshooting commands (pihole -g, pihole restartdns, dig against Pi-hole).

Compatible agents

Likely useful to general automation and ops-focused agents (Copilot/Codex/CLI-capable agents) that can surface step-by-step instructions or generate infra config files.