pihole
command-line interface for managing Pi-hole, a network-level ad blocker
TLDR
Check Pi-hole status
$ pihole status
Update Pi-hole$ sudo pihole -up
Enable or disable blocking$ pihole enable
$ pihole disable
Update gravity (block lists)$ pihole -g
Allow or deny a domain$ pihole allow example.com
$ pihole deny example.com
Query for a domain in lists$ pihole -q example.com
View real-time log$ pihole -t
Reload DNS without restart$ pihole reloaddns
SYNOPSIS
pihole [command] [options]
DESCRIPTION
pihole is the command-line interface for managing Pi-hole, a network-level ad and tracker blocking application that acts as a DNS sinkhole.
PARAMETERS
status
Show current Pi-hole statusenable
Enable Pi-hole blockingdisable [TIME]
Disable Pi-hole blocking (optionally for specified time)-up, updatePihole
Update Pi-hole to the latest version-g, updateGravity
Update the gravity database (block lists)allow DOMAIN
Add domain to the allow listdeny DOMAIN
Add domain to the deny list-q, query DOMAIN
Search lists for a domain-t, tail
View real-time log of DNS queriesreloaddns
Reload DNS lists and flush cache without restartrestartdns
Restart the DNS server-c, chronometer
Display real-time stats in console-a, admin
Admin console options (password reset, etc.)checkout
Switch Pi-hole branches (for development)
INSTALL
nix profile install nixpkgs#pihole
CAVEATS
Most commands require root privileges or use of sudo. Pi-hole acts as a DNS server, so disabling it affects all devices using it for DNS. The web admin interface provides additional management options.
HISTORY
Pi-hole was created as a network-wide ad blocker that runs on a Raspberry Pi (or other Linux system) to block advertisements and tracking at the DNS level.
