A command line tool to enable/disable your pihole

Sometimes you just need to disable your pihole for some website to work. PiholeSwitch makes this operation much easier.

Just open a terminal, and you can disable pihole in a moment and for as long as you want.

• Installation
• Usage
• License

$ curl -s https://raw.githubusercontent.com/devmatteini/pihole-switch/master/install.sh | bash

Download the latest release and unzip the phs.zip file.

After the archive is unzipped, move the phs binary in a folder included in your $PATH (it's commonly used /usr/local/bin).

git clone https://github.com/devmatteini/pihole-switch && cd pihole-switch
cargo build --release
./target/release/phs

Export an environment variable PIHOLE_TOKEN=<pihole_api_token>.

You can find the api token here: http://pi.hole/admin/settings.php?tab=api, then under the section Query log, click on the button Show API token and confirm.

Enable pihole

$ phs enable

Disable pihole (indefinitely)

$ phs disable

Disable pihole for 20 seconds

$ phs disable --time 20

If your device doesn't have pihole set as dns

$ phs --host 192.168.1.50 disable

(where 192.168.1.50 is the pihole ip address)

Enable/disable by passing the api token as an argument, instead of using the PIHOLE_TOKEN environment variable

$ phs enable <api_token>

Note: the PIHOLE_TOKEN environment variable will always have priority even if you pass the api token as an argument

pihole-switch is made available under the terms of the MIT License.

See the MIT License file for license details.