A. Command Reference

Basic Commands

System Management

• pihole -g - Update the list of ad-serving domains
• pihole status - Display the running status of Pi-hole subsystems
• pihole enable - Enable Pi-hole subsystems
• pihole disable [time] - Disable Pi-hole subsystems
  • Time options: #s (seconds), #m (minutes)
  • Example: pihole disable 5m - Disable for 5 minutes

DNS Management

• pihole restartdns - Full restart of Pi-hole subsystems
  • reload - Updates lists and flushes DNS cache
  • reload-lists - Updates lists without flushing DNS cache

List Management

• pihole -w [domain(s)] - Add domains to whitelist
• pihole -b [domain(s)] - Add domains to blacklist
• pihole --wild [domain(s)] - Add wildcard domains to blacklist
• pihole --white-wild [domain(s)] - Add wildcard domains to whitelist
• pihole --regex [regex] - Add regex filters to blacklist
• pihole --white-regex [regex] - Add regex filters to whitelist

List manipulation options:

• -d, --delmode - Remove domain(s)
• -nr, --noreload - Update without refreshing dnsmasq
• -q, --quiet - Less verbose output
• -l, --list - Display all listed domains
• --nuke - Remove all entries in a list

System Maintenance

• pihole -f - Flush the Pi-hole log
• pihole -r - Reconfigure or repair Pi-hole
• pihole -up - Update Pi-hole subsystems
  • --check-only - Check for updates without installing

• pihole uninstall - Uninstall Pi-hole

Administrative Functions

Web Interface

• pihole -a -p password - Set Web Interface password
• pihole -a -l privacylevel - Set privacy level (0-3)
• pihole -a -i interface - Specify dnsmasq's interface

Temperature Units

• pihole -a -c - Set to Celsius
• pihole -a -f - Set to Fahrenheit
• pihole -a -k - Set to Kelvin

Logging

• pihole -l on - Enable logging
• pihole -l off - Disable and flush logs
• pihole -l off noflush - Disable logging without flushing
• pihole -t [arg] - View live output of Pi-hole log
  • Optional argument to filter log (supports regex)

Development and Debugging

Version Management

• pihole -v - Show versions of Pi-hole components
  • -p, --pihole - Pi-hole core version
  • -a, --admin - Web interface version
  • -f, --ftl - FTL version
  • -c, --current - Current version
  • -l, --latest - Latest version
  • --hash - Show GitHub hash

Branch Management

pihole checkout [repo] [branch]

• Repos: core, web, ftl
• Branches: master, dev, or specific branch name

Debugging

• pihole -d - Start debugging session
  • -a - Enable automated debugging

Query Tools

• pihole -q [options] - Query adlists for domains
  • -adlist - Print block list URL
  • -exact - Search for exact matches
  • -all - Show all query matches