Config Files

PiHole Configuration Files

/etc/dnsmasq.d/

All files contained in this folder are used as config files as defined in /etc/dnsmasq.conf :

/etc/dnsmasq.conf

conf-dir=/etc/dnsmasq.d

01-pihole.conf

Main configuration file for PiHole's dnsmasq.

This file is overwritten by PiHole updates / upgrades! Any custom changes should be made in separate files in /etc/dnsmasq.d/

/etc/pihole/

This folder contains multiple configuration files for PiHole's setting

/etc/pihole# ls

GitHubVersions    blacklist.txt       install.log                 localversions    regex.list                 whitelist.txt.old
adlists.list      blacklist.txt.bck~  list.0.dbl.oisd.nl.domains  logrotate        setupVars.conf
adlists.list.old  dhcp.leases         list.preEventHorizon        macvendor.db     setupVars.conf.update.bak
auditlog.list     dns-servers.conf    local.list                  pihole-FTL.conf  whitelist.txt
black.list        gravity.list        localbranches               pihole-FTL.db    whitelist.txt.bck~

adlists.list

Blocklists used to generate Pi-hole's Gravity list

auditlog.list

The audit log is a list that contains all domains that have been found in the Pi-hole log. When you click on [Audit], it will be removed from this table and appended to /etc/pihole/auditlog.list, so that it won’t be shown in the future, and so you can view the domains that have already been audited.

Sites listed in /etc/pihole/auditlog.list will not appear on the Pi-hole Audit Log

setupVars.conf

WEBPASSWORD=<HASHED-PASSWORD>
PIHOLE_INTERFACE=eth0
IPV4_ADDRESS=192.168.1.1/24
IPV6_ADDRESS=
QUERY_LOGGING=true
INSTALL_WEB_SERVER=true
INSTALL_WEB_INTERFACE=true
LIGHTTPD_ENABLED=true
DNSMASQ_LISTENING=single
PIHOLE_DNS_1=1.1.1.1
PIHOLE_DNS_2=1.0.0.1
DNS_FQDN_REQUIRED=false
DNS_BOGUS_PRIV=false
DNSSEC=false
CONDITIONAL_FORWARDING=false
BLOCKING_ENABLED=true

Upstream DNS providers can be configured with PIHOLE_DNS_1= & PIHOLE_DNS_2=