HOWTO: Using pi-hole as LAN DNS server

What's the log look like when you request the domains? /var/log/pihole.log

It appears that only the times that the domains are resolved correctly are logged. I just performed multiple nslookups which were resolved to the domain's external address, and none were logged, yet the log is full of entries resolving the domain to the correct internal address. I did however see this logged while I was testing, at the point where it started resolving correctly:

Dec 6 22:02:08 dnsmasq[140838]: query[AAAA] my.domain from
Dec 6 22:02:08 dnsmasq[140838]: forwarded my.domain to
Dec 6 22:02:08 dnsmasq[140838]: validation result is INSECURE
Dec 6 22:02:08 dnsmasq[140838]: reply my.domain is NODATA-IPv6

That sounds like your device is using more than just Pi-hole as the DNS server (or further upstream in the router it's using something else)

I'm having exactly the same issue as @koolmon10. Installed Pi-Hole. Set up Pi-Hole. DHCP server enabled. Added a bunch of static DHCP leases. On the Pi-Hole itself (and other devices) half the local hostnames resolve and half don't.

If I ping bose-lounge.local the IP resolves, and the following goes into /var/log/pihole.log

Dec 20 17:13:28 dnsmasq[28202]: DHCP is bose-lounge.local

If I ping bose-kitchen.local however, it fails to resolve and I see the following:

Dec 20 00:19:15 dnsmasq-dhcp[28202]: DHCPREQUEST(eth0) 88:4a:ea:78:37:2e
Dec 20 00:19:15 dnsmasq-dhcp[28202]: DHCPACK(eth0) 88:4a:ea:78:37:2e bose-kitchen

The odd thing is is correct for bose-kitchen.local but it never actually resolves.

Edit: actually the bose-kitchen mention in pihole.log doesn't happen when I try to resolve the hostname, nothing gets printed in the log. Just happened to be there from earlier.

Edit 2: This gets weirder. If I ping bose-kitchen.local it does not work. If I remove the local it works fine but shows as .local!

pi@pi-hole:~ $ ping bose-kitchen.local
ping: bose-kitchen.local: Name or service not known

pi@pi-hole:~ $ ping bose-kitchen
PING bose-kitchen ( 56(84) bytes of data.
64 bytes from bose-kitchen.local ( icmp_seq=1 ttl=64 time=107 ms

Thought I'd start a new reply rather than make a third edit!! :slight_smile:

So I've discovered that (certainly on my LAN) it's a crapshoot with the .local domain:

  • Some hosts can be resolved with .local and without .local on the end
  • Some hosts can only be resolved with .local on the end
  • Some hosts can only be resolved without .local on the end

All have just been configured via the DHCP leases setting via the web front end..

I have found a fix though. Change the "Pi-hole domain name" to something other than .local (I just tried .home) and now everything works both with and without .home on the end!

Hmm, maybe your router or your upstream DNS server doesn't like .local as there is nothing specific about this TLD in our DNS server that would make me expect such a thing.

Is that really appearing when you ping? This should be there as a request to establish, verify or extend an existing lease, hence it should be totally independent of you pinging the kitchen system.

It's possible your issues may be related to mDNS, which I believe uses .local as the default domain name. mDNS is what most devices use to discover others on the network. It's what lets your phone find your Chromecast, etc.

I already posted this on reddit but will do so here again, since it completely resolved my DNS resolution issues with Pi-Hole in Windows (7, 8.1 and 10).

tl;dr: disable IPv6 in Network Adaper settings AND disabled IP-Helper service!

If you have any issues with local DNS resolution on Windows, although every is set up correctly as explained in the article below then try the following: 1. Disable IPv6 in your network adapter settings 2. (Important!) Stop and disable "IP Helper" service. 3. run "ipconfig -flushdns" from elevated command prompt.

I had been struggeling with local DNS resolution issues for a long time and discovered this by accident. Since I had disabled IPv6 in my network adapter settings, I was foolishly under the assumption that IPv6 was disabled on my Windows 10 but apparently Microsoft thought otherwise.

After trying to optimize my setup a bit, I stumpled upon an article that suggested to disable "IP Helper" service since its not needed in most scenarios anyway and also mentioned IPv6. The moment I stopped the service and flushed the DNS cache, all issues with local DNS resolution were gone.

Not sure why Windows still tries to do DNS resolution via IPv6 although it is disabled in the network adapter settings (I only have one), but I m glad I finally finally figured that out (after almost a year of frustration and editing "hosts" files).

Please spread the word to all that have the same issue so they wont have to struggle as long as I did :smiley:

Pi-Hole for local DNS resolution setup: HOWTO: Using pi-hole as LAN DNS server

minor problem is that Chrome/Opera browser treats the address as search (unless you put http:// in front). How to change this, if possible?

Note: restarting dnsmasq didn't seem to work for me, but pihole restartdns worked.

1 Like

I have found this to be simpler that the above. Simply edit the /etc/hosts file on the Pi-hole and put the IP and FQDN in.

The line in the man page for dsnmasq that gives a clue:

It loads the contents of /etc/hosts so that local hostnames which do not appear in the global DNS can be resolved

I now have a wildcard SSL certificate and multiple machines on my LAN happily serving over HTTPS. I do have to update the certificate onto each machine - I may look at a reverse proxy (or maybe not!)

An even easier solution is to put:


in the 01-pihole.conf file, which is what adding the router and domain under Settings>DNS does. If you have multiple domains, which we do, you can add an entry for each domain. We're using Pi-Hole on three enterprise LANs (each of which uses MS Active Directory with DHCP and DNS) using this method and everything resolves just fine when looking up just the hostname.


Hos does option 2 work? Which settings should i use?

My router is currently using pi hole as dns and pi Hole uses cloudflared (dns over https)

5 posts were split to a new topic: Local Domain configuration ideas

This feature is called "Conditional Forwarding".

I'm trying to setup a LANCache server on my Pi, to do so I need to forward the IP addresses of the normally-external download servers to an internal IP. How should I do this using the configuration file? I've found a blog post that suggests using the syntax address=/<external_address>/<internal_IP> - is this advisable?

if you want to use pihole and lancache together i'd recommend just

  1. make pihole your primary dns server

  2. point piholes upstream dns server to lancache

  3. configure lancache as needed

this should work since all pihole is doing is black listing domains and gets a-records from upstream

I'm new to Pi-hole.

I have a similar file called /etc/pihole/local.list which has the two local names for pihole and the respective addresses. Silly question but could I put my local hostnames and their respective addresses in this file?

Does the new Pi-Hole 5.0 replace this HOWTO? I see there is a new function in the web GUI called Local DNS Records. I suspect that Pi-Hole 5.0 still works with the steps from this HOWTO applied.