Claude MarketplacesSubmit

Homelab Pihole Dns

Gives Claude everything it needs to set up and maintain Pi-hole as your home network's DNS server. Covers Docker and bare-metal installation, configuring your router to point all devices at it, managing blocklists, setting up DNS-over-HTTPS with cloudflared, and creating local DNS records so you can reach your homelab services by name. The troubleshooting section is solid for when devices lose internet after installation or when you accidentally block something legitimate. If you're running a homelab and tired of configuring ad blockers on every device, this walks through the whole stack including the DHCP integration decisions you'll actually face.

skills.sh installs: 5.4K
GitHub stars: 300.3K
last updated: Aug 21, 2026

Install

$ npx -y skills add affaan-m/ecc --skill homelab-pihole-dns --agent claude-code

Installs 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)

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Details

Repository: github.com/affaan-m/ecc
Category: Debugging
First seen: Jul 14, 2026

Recommended

1

axiom-sreaxiomhq/skillsExpert SRE investigator for incidents and debugging. Uses hypothesis-driven methodology and systematic triage. Can query Axiom observability when available. Use5.4Kskills.sh installs

2

sre-engineerjeffallan/claude-skillsDefines service level objectives, creates error budget policies, designs incident response procedures, develops capacity models, and produces monitoring configu5.4Kskills.sh installs

3

skill-improvertrailofbits/skillsIteratively reviews and fixes Claude Code skill quality issues until they meet standards. Runs automated fix-review cycles using the skill-reviewer agent. Use t5.4Kskills.sh installs

4

energy-procurementaffaan-m/eccCodified expertise for electricity and gas procurement, tariff optimization, demand charge management, renewable PPA evaluation, and multi-facility energy cost 5.4Kskills.sh installs

5

network-bgp-diagnosticsaffaan-m/eccDiagnostics-only BGP troubleshooting patterns for neighbor state, route exchange, prefix policy, AS path inspection, and safe evidence collection.5.4Kskills.sh installs

6

alloygrafana/skillsBuild a unified telemetry pipeline with Grafana Alloy — one OpenTelemetry-compatible binary that collects metrics, logs, traces, and profiles and ships to Grafa5.4Kskills.sh installs