Files
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

84 lines
1.6 KiB
Markdown

# 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
```
4. Update gravity: `pihole -g`
---
## Customizing
Edit the files to add/remove domains:
```bash
# 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