Troubleshooting guide
Test Pi-hole on One Device and Restore the Original DNS
Category: DNS Filtering
pi-hole breaks internet.
Pi-hole is safest when one client is tested first. Record the original DNS so a failed test is a two-minute rollback, not a household outage.
Before you start
- Pi-hole IP address and admin access
- One test computer or phone
- The current DNS setting and router access
- A known ad domain and a normal website
Step-by-step checks
Step 1: Capture the current DNS
Open the test device's network settings and record whether DNS is automatic or manual. If manual, copy every address; if automatic, note the router/DHCP source.
Check: A screenshot or written copy of the original DNS exists.
Step 2: Set only the test device
Set the device's DNS to the Pi-hole address, then reconnect Wi-Fi or renew the lease. Do not change the router yet.
Check: The device's active DNS shows the Pi-hole address.
Step 3: Confirm the query path
Visit a normal site and a known ad-test domain. Open Pi-hole's query log and find the test device's queries.
Check: The Pi-hole log shows queries from the test device.
Step 4: Test a normal browsing session
Load several sites, check email or a video call, and note any false positives. Disable blocking for one domain only if needed and document why.
Check: Normal browsing works and the intended block is visible.
Step 5: Restore the original DNS
Put back the recorded DNS or automatic setting, reconnect, and load the same sites. Confirm the device no longer depends on Pi-hole.
Check: The original DNS is active and browsing works after rollback.
Verify the result
The device used Pi-hole for DNS, a known block appeared in the log, normal browsing worked, and the original DNS restored cleanly.
Rollback
Use the recorded DNS screenshot. If the router was changed, restore its previous DNS entries and renew client leases.
Ask for help with this exact symptom · All troubleshooting guides