Pihole Switch

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.

Table of contents

• Installation
• Usage
• License

Installation

Recommended

curl -s https://raw.githubusercontent.com/devmatteini/pihole-switch/main/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).

From DRA

Using dra you can download and install the latest release

dra download -s phs.zip --install devmatteini/pihole-switch
./phs --version

From source

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

Usage

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.

Commands

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 option, instead of using the PIHOLE_TOKEN environment variable

phs --token <token> <SUBCOMMAND>

Note: the api token passed as an option will always have priority on the PIHOLE_TOKEN environment variable

License

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

See the MIT License file for license details.