Files
public-setupfiles/pihole/README.md
T

84 lines
1.6 KiB
Markdown
Raw Normal View History

# 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