Pi-hole has traditionally returned a blank HTML page in place of advertisements. An alternative method is to return
NXDOMAIN—no such domain. This is a behaviour you asked us to implement and we have listened.
To use it, you’ll need to be running the FTLDNS beta (
pihole -up if you’re already on it):
echo "FTLDNS" | sudo tee /etc/pihole/ftlbranch pihole checkout core FTLDNS pihole checkout web FTLDNS
You can also checkout the
development branches, but if you want the most up-to-date code, use the
Once you’ve checked out on the new branches, you need to add this to
/etc/pihole/pihole-FTL.conf(note you may need to create this file if it does not exist)
depending on which method you prefer and then restart FTLDNS (
pihole-FTL) to apply the change
sudo service pihole-FTL restart
What Is NXDOMAIN?
This is a mechanism built into DNS that can be returned as an answer when the domain doesn’t exist. You can see this response by using
nslookup on a domain that is not likely to be registered:
me@pihole:~$ nslookup skfmndfosfmmpofpwmf.com Server: 22.214.171.124 Address: 126.96.36.199#53 ** server can't find skfmndfosfmmpofpwmf.com: NXDOMAIN
Benefits And Drawbacks Of Serving HTML Or Using A 404 (The current method)
- The block page can be used and is fully functional
- Additional software to run the Web server is needed
- Performance may be slightly impacted
- Firewall rules are often needed to prevent slow loading pages (But even then you can still run into issues with certain routers)
Benefits And Drawbacks Of NXDOMAIN
- Improved speed and performance
- No Web server needed
- No connections made to Pi-hole for blocked domains (except for the DNS request itself)
- No firewall rules needed
- Block page will not work
- You may see a browser error for blocked domains
- If you visit a blocked domain directly, your browser may say the domain doesn’t exist, which may be confusing
- Some connections will still try to connect to the non-existant domain for a few tries before it times out
What About Null Blocking?
Another method is null blocking, which responds with 0.0.0.0 or ::1. This special IP address is unspecified.
Benefits And Drawbacks
These are similar to that of
NXDOMAIN but this is more experimental so your mileage may vary,
Thanks to you, we can keep working on Pi-hole and implementing features you want. We’re currently running a fundraiser so please consider donating to our project!
One-time funding goal for developing full time, faster updates, faster bug fixes, quicker support response times, more features, more platforms natively supported…
If you’d like to support the development of Pi-hole, use the form above to send us a donation (monthly or a one-time).
You can also help us out by becoming a patron or purchasing items/services through our affiliate links below.
- Digital Ocean
- UNIXstickers.com Save $5 when you spend $9 (or upvote our sticker so they can be sold)
- Stickermule (earn a free $10 credit using our link)
- Pi-hole® Swag Store
- DNS Made Easy
- Patreon (creator referral)
- Bitcoin 33v5DGMGwYiDDJsKExksY1jhZbhGqF1SVe
- Bitcoin Cash
We are all volunteers on the project and work on it in our free time. Your donations will help support our infrastructure and keep us motivated to improve the product.
No registration is needed.