Disable PiHole from iPhone 1-click

Jun 7, 2021 ios

This post is more than 18 months old. Since technology changes too rapidly, this content may be out of date (but that's not always the case). Please remember to verify any technical or programming information with the current release.

If you’re running PiHole as your DNS, you might run into situations where you want to disable it quickly. By making a shortcut on my iPhone, I can quickly disable (or re-enable) PiHole. Let me show you how.

First, make sure you know what the IP or hostname of your PiHole install is. On my network, mine is pihole.local - yours mine be something else. Make sure your iPhone is on your same network and can surf to that domain. If so, then you’re good to go.

Next, get your API token from PiHole. To do this, access the Settings menu after logging into your admin portal of your PiHole. Then click the API/Web Interface tab and click the Show API Token button towards the bottom. Grab the raw text API token here. (If you’ve shared your clipboard through iCloud, you can copy this on your mac and paste it when you’re using your iPhone.)

Now, open your iPhone’s Shortcut App and click the plus sign to create a new shortcut.

Click the three dots to change the icon and the name. I’ve chosen a relevant name and a different color/icon.

Click the Add action button and search for Text.

Place your API key in the text field all by itself (make sure there’s no extra spaces or no letters mistakenly capitalized).

Click the Plus again and search for “Get contents” to find the Get Contents of URL action. Select this.

Type the following URL into your Network action: http://pihole.local/admin/api.php?disable&auth= where pihole.local is your local PiHole. The = should then have the Text placeholder after it. This will insert your api key.

I also opted to add a “show notification” action to confirm the action has completed.

Now you have an action that you can click to execute with one click. You can put this in one of your iOS widgets if you’d like.

A couple things…

When you run it the first time, it might prompt you for permission to access the internet. You should allow this shortcut to do that. It says ‘internet’ but really it’s referring to your local server on your network.

You can also create a re-enable functionality by changing the disable to enable in the URL. Everything else would function the same.