Troubleshooting guide

Pi-hole DNS Resolution Failed: Restore Internet After Installation

Category: DNS Filtering

You installed Pi-hole on your home LAN, pointed your clients at it, and now name resolution fails so the internet appears broken.

Confirm the failure before changing anything

On a client, run nslookup example.com (or dig example.com). If it times out or returns no address, the client is not getting answers from Pi-hole. Next, run nslookup example.com <pi-hole-IP> to query Pi-hole directly. If that also fails, the problem is Pi-hole’s upstream DNS, not the client. If it succeeds, check the client’s configured DNS server and router DHCP settings.

Check Pi-hole’s upstream DNS

Open the Pi-hole admin page and go to Settings > DNS. Confirm at least one upstream resolver is enabled and reachable. From the Pi-hole host, run nslookup example.com 1.1.1.1. If this fails, Pi-hole has no working upstream path, which explains why pi-hole dns resolution failed for every client.

Verify resolution end to end

After correcting the upstream setting, restart Pi-hole’s DNS service, then repeat nslookup example.com <pi-hole-IP> from a client. A returned address means resolution works; a timeout means the service is not listening or the firewall is blocking port 53.

Roll back if clients still cannot resolve

If clients remain offline, temporarily set their DNS back to the router address or a public resolver so the household regains internet. Then re-check Pi-hole one step at a time rather than changing multiple settings at once. For guided diagnosis,

A laptop showing Pi-hole query logs and DNS settings

Ask for help.

Repeat the same check after a restart and confirm the result twice.


Back to the service page · Ask about this exact symptom