Troubleshooting category
DNS Filtering
Single-device Pi-hole checks for DNS resolution, blocking, and safe rollback. Start with the guide below, then use the service page if the symptom needs a remote session.
Router DNS Settings Override Pi-hole: Fix the DHCP Handout
Router still handing out its own DNS instead of Pi-hole? Follow these checks to fix the pi-hole router dns setting and verify the DHCP handout.
Pi-hole Breaks Internet After Install: Restore DNS Resolution
Clients lose name resolution after pointing DNS at Pi-hole. Follow these checks to isolate the upstream DNS failure and restore internet access.
Router DNS Settings Override Pi-hole: Stop the Router From Handing Out Its Own DNS
Router still handing out its own DNS instead of Pi-hole? Follow these checks to fix pi-hole router dns settings override and verify the DHCP handout.
Pi-hole Gravity Update Failed: Fix Ad Blocking When Queries Still Resolve
Pi-hole gravity update failed? Queries still resolve but ads are no longer blocked. Follow these steps to diagnose and restore ad blocking.
Pi-hole Whitelist Domain Entry Not Unblocking: Check Order and Lists
A whitelisted domain still blocked in Pi-hole? Learn how to check list precedence, exact domain matching, and verify with a controlled query.
Pi-hole Device Not Using DNS: Fix One Device That Still Bypasses Pi-hole
One device still uses another DNS server and shows no Pi-hole queries. Follow these checks to confirm and fix a single-device DNS bypass on your home LAN.
Internet Breaks After Pi-hole Install: Quick DNS Resolution Fix
Internet breaks after Pi-hole installation? Follow these steps to diagnose and fix pi-hole dns resolution failed on your home LAN.
Pi-hole Not Blocking Ads: Diagnose the Query Path Before You Change Anything
Ads resolve again because queries are bypassing Pi-hole or gravity is empty. Learn the exact checks to confirm the query path and restore blocking.
Pi-hole Breaks Internet: Isolate the DNS Failure Before Changing Settings
Clients lose name resolution after pointing DNS at Pi-hole. Learn to isolate the failure, run a verification test, and roll back safely.
Pi-hole Conditional Forwarding Loop: Fix Missing Local DNS Records
Troubleshoot a Pi-hole conditional forwarding loop that leaves local hostnames missing or wrong. Step-by-step checks, exact result interpretation, and a verification test.
Pi-hole Upstream DNS Timeout: Fix Internet After Installation
Clients lose name resolution after pointing DNS to Pi-hole. Diagnose a pi-hole upstream dns timeout and restore internet access with a controlled test and rollback.
Pi-hole Blocklist Not Loading: When a Whitelist Entry Still Blocks a Domain
Troubleshoot a Pi-hole whitelist entry that fails to unblock a domain. Check list loading, exact match, regex, and client cache before changing settings.
Pi-hole Blocklist Not Loading: Restore Ad Blocking When Queries Resolve but Ads Appear
Pi-hole resolves queries but known ad domains are no longer blocked. Follow these checks to restore ad blocking when the blocklist fails to load.
Pi-hole DHCP DNS Conflict: One Device Still Bypasses Pi-hole
Troubleshoot a Pi-hole DHCP DNS conflict where one device still uses another DNS server. Follow checks, interpretation, and a verification test to restore expected Pi-hole queries.
Pi-hole Local DNS Record Missing: Fix a Hostname That Resolves Wrong or Not at All
A local hostname resolves to the wrong address or not at all. Follow these checks to restore the missing Pi-hole local DNS record and verify resolution.
Pi-hole Breaks Internet After Install: Fix DNS Resolution on Your LAN
Clients lose name resolution after pointing DNS at Pi-hole. Follow these checks to restore internet access and verify DNS resolution.
Pi-hole Gravity Update Failed: Restore Ad Blocking After a Failed Update
Pi-hole gravity update failed and ads are no longer blocked? Follow these checks to diagnose the failure, restore blocking, and verify with a test.
Pi-hole Whitelist Domain Not Working: Fix an Allow Entry That Still Blocks
A domain on your Pi-hole allow list is still blocked. Follow these checks to confirm the whitelist entry is active, rule out client bypass, and verify the fix.
Router DNS Override: Stop Your Router From Handing Out Its Own DNS Instead of Pi-hole
Your router is handing out its own DNS instead of Pi-hole. Follow these checks to fix the pi-hole router dns setting and verify clients use Pi-hole.
Router DNS Settings Override Pi-hole: Fix DHCP Handout
Router still handing out its own DNS instead of Pi-hole? Check the DHCP DNS field, LAN DNS override, and IPv6 RA settings, then verify with a client test.
Pi-hole Breaks Internet: Restore DNS After Installation
Clients lose name resolution after pointing DNS at Pi-hole. Follow these checks to restore internet access and verify DNS.
Pi-hole Device Not Using DNS: One Device Still Bypasses Pi-hole
Troubleshoot a single device that still uses another DNS server and shows no Pi-hole queries. Follow checks, interpret results, and verify the fix.
Pi-hole DNS Resolution Failed: Restore Internet After Installation
Clients lose name resolution after pointing DNS at Pi-hole. Follow these checks to confirm the failure, test resolution, and roll back if needed.
Pi-hole Not Blocking Ads: Diagnose Before You Change Anything
Pi-hole resolves queries but stops blocking known ad domains on a router-DNS home LAN. Run these checks to confirm the cause and restore blocking.
Pi-hole Whitelist Domain Not Working: Why an Allow Entry Still Blocks a Domain
A domain added to the Pi-hole allow list is still blocked. Follow these checks to confirm the entry, clear cache, and verify the fix.
Test Pi-hole on One Device and Restore the Original DNS
A controlled Pi-hole test that proves DNS filtering on one client and restores the original settings.