Files
public-setupfiles/pihole
WickedYodaandJarvis 0c62f7495a docs: add READMEs and wiki documentation for all directories
- Add comprehensive wiki documentation under .github/wiki/ (19 articles)
- Add READMEs to directories that lacked them
- Fix merge conflict markers in existing READMEs
- Update root readme.md with improved structure

Co-authored-by: Jarvis <jarvis@wickedyoda.local>
2026-09-04 12:31:11 -05:00
..

pihole

Overview

Pi-hole DNS blocking and domain list resources for ad-blocking and content filtering.


Files

File Description
blocklist.txt Comprehensive domain blocklist
whitelist.txt Domains to allow through
combined_list.txt Merged block + allow lists

Blocklist

blocklist.txt

A comprehensive list of domains to block via DNS, including:

  • Advertising networks
  • Analytics trackers
  • Social media domains
  • Adult content sites
  • Known malware domains

This is the primary source for Pi-hole's DNS blocking.

whitelist.txt

Domains that should always resolve normally:

  • Local services
  • Required CDN domains
  • Cloud services

combined_list.txt

A ready-to-use combined list that can be imported directly.


Usage with Pi-hole

Adding Blocklist

  1. Open Pi-hole Admin Console
  2. Group Management → Adlists
  3. Add these URLs:
https://raw.githubusercontent.com/wickedyoda/public-setupfiles/main/pihole/blocklist.txt
https://raw.githubusercontent.com/wickedyoda/public-setupfiles/main/pihole/whitelist.txt
  1. Update gravity: pihole -g

Customizing

Edit the files to add/remove domains:

# Edit blocklist
nano pihole/blocklist.txt

# Edit whitelist
nano pihole/whitelist.txt

# Regenerate combined list
cat pihole/blocklist.txt pihole/whitelist.txt > pihole/combined_list.txt

Notes

  • Whitelist domains should be a small, trusted list
  • Too many whitelisted domains can create security issues
  • Review lists periodically for accuracy
  • Test new lists before deploying to production Pi-hole instances