Skip to content

zachlagden/Pi-hole-Optimized-Blocklists

Repository files navigation

Pi-hole Optimized Blocklists

Total Domains Updated Weekly License

Pre-optimized, deduplicated blocklists for Pi-hole

Looking for more features? Check out Zach's Lists — a full-featured blocklist platform with custom source selection, smart whitelisting, and multiple output formats.


Available Lists

List Description Domains
all_domains.txt Everything combined (except NSFW) 2,088,235
advertising.txt Ad networks & services 102,053
tracking.txt Analytics & telemetry 35,653
malicious.txt Malware, phishing, scams 1,559,736
suspicious.txt Potentially unwanted 72,031
comprehensive.txt Curated multi-category 640,900
nsfw.txt Adult content (separate) 545,205

Note: nsfw.txt is not included in all_domains.txt because it blocks legitimate adult sites. Add it separately if you want NSFW blocking.

Last updated: April 19, 2026

Quick Start

  1. Go to Pi-hole admin → SettingsAdlists
  2. Add the raw URL for your chosen list(s)
  3. Run pihole -g to update

Report a Domain

Found a domain that should be blocked or a false positive? Open an issue using one of the templates:

  • Block Domain — request a malicious, ad, tracking, or suspicious domain to be blocked
  • False Positive — report a legitimate domain that's being incorrectly blocked
  • Bug Report — report a problem with the lists or automation

Claude will automatically process your request and create a PR. The maintainer reviews and merges it, and the change takes effect on the next weekly update.

FAQ

What's the difference between this and Zach's Lists?

This repository provides static, pre-built blocklists updated weekly. Zach's Lists offers additional features:

  • Custom source selection — pick which blocklists to include
  • Smart whitelisting — regex, wildcards, subdomain patterns
  • Multiple formats — hosts, plain, and Adblock syntax
  • Real-time build progress

Both use the same underlying sources and are maintained by the same person.

How often are these lists updated?

Every Sunday at midnight UTC via GitHub Actions. Community-reported domains are included once their PR is merged before the next run.

Which list should I use?
  • comprehensive.txt — Good balance for most users
  • all_domains.txt — Maximum blocking (may cause false positives)
  • Individual category lists — If you want granular control
How do community-reported domains work?

Domains reported via issues are added to custom/<category>.txt files in the repo. These are referenced as sources in blocklists.conf via raw GitHub URLs, so the optimizer picks them up on the next weekly run just like any other upstream source.

Contributing

See CONTRIBUTING.md for details on how to report domains, submit PRs, and use the automated workflows.

Sponsors

Thanks to everyone who supports this project.

One-Time

@rnsimmons

Star History

Star History Chart

License

MIT License — see LICENCE for details.

About

Pre-optimized, deduplicated Pi-hole blocklists — 1.6M+ domains across advertising, tracking, malware, and more. Updated weekly.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors