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


Back to the service page · Ask about this exact symptom