NXDOMAIN And Null Blocking With FTLDNS

Pi-hole has traditionally returned a blank HTML page in place of advertisements.  An alternative method is to return NXDOMAINno 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 FTLDNS branches.

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


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 can't find skfmndfosfmmpofpwmf.com: NXDOMAIN

There are benefits and drawbacks to both methods, but NXDOMAIN response has been an open feature request for some time.  This functionality is now available in FTLDNS.

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 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,

Your Support

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…

$28,710 of $100,000 raised
Select Payment Method
Personal Info

Donation Total: $25.00 One Time

{amount} donation plus {fee_amount} to help cover fees.

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.

  • Bitcoin 33v5DGMGwYiDDJsKExksY1jhZbhGqF1SVe
  • Bitcoin Cash  qquhjgl9l5yfghu2kmw7q495m4xdgfc4q59zntpjmh
  • Ethereum 0x5Cd7f79D8D542847B2A313297037d3CAc1FeFBB4

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.


Notable Replies

  1. Done. Thanks for the hint.

  2. I also edited the original blog article now.

  3. I am using the NXDOMAIN now, instead of the redirection to and everything seems to work faster. Thanks!

  4. Am I wrong or NXDOMAIN is now the default behavior for pi-hole?

    I was starting to implement this method by following this guide, but I decided to check using nslookup just before doing it… and it seems that my pi-hole is replying with NXDOMAIN instead that its own IP address or

    My current setup is:
    Raspbian 9 (stretch)
    Pi-hole version is v3.3.1 (Latest: v3.3.1)
    AdminLTE version is v3.3 (Latest: v3.3)
    FTL version is v3.0 (Latest: v3.0)

  5. With FTLDNS, the new default method is NULL blocking as described here.

    NXDOMAIN turned out to be disadvantageous in some cases where clients tried to resolve hostnames like crazy as they didn’t accept NXDOMAIN as reply.

Continue the discussion discourse.pi-hole.net

11 more replies


17 Replies to “NXDOMAIN And Null Blocking With FTLDNS”

Leave a Reply