📓
Knowledge
  • Knowledge Base
  • Applications
    • Gitbook
      • CSS Overrides
    • PiHole
      • Automated Whitelist Script
      • Block Lists
      • Config Files
      • DNS over HTTPS
      • Local DNS
    • SSH
      • SCP
      • SSH Keys
        • ssh-add
        • ssh-agent
        • ssh-keygen
      • SSH on Windows
      • SSH on macOS
    • Youtube-DL
      • Youtube-DL Config File
      • Youtube-DL .netrc File
  • Linux
    • Administration
      • dmesg
      • Unattended Upgrades
      • cron
        • cron.d Directory
        • Listing cron jobs
      • sudo
        • BUG: setrlimit(RLIMIT_CORE) Error
        • Add Sudo Privileges to User
      • System Restart Required
    • Applications
      • Apache
      • ddclient
        • Installing Latest (ddclient)
        • Cloudflare DNS (ddclient)
        • Commands (ddclient)
      • PHP
      • NGINX
        • Configuration Files Structure
    • Commands
      • ln -s : Symbolic Links
      • rsync
    • File System
      • File Management
        • Extended Attributes
        • find (command)
        • rsync (command)
        • tar (command)
      • File Sharing
        • AFP
        • SAMBA
        • NFS
      • Volume Management
      • ZFS on Linux
        • Reference Guides
        • Installing ZFS on Debian
        • Migrating ZFS Pools
        • sharenfs - Native ZFS NFS shares
    • Hardware
    • Networking
      • Disable IPv6
    • New System Setup
      • Debian Setup Guides
      • Disable CloudInit (Ubuntu)
      • Recommended packages
    • Package Management
      • apt Commands
      • apt Logs & History
      • Getting info about Packages
      • dpkg
      • dpkg-query
    • Performance & Diagnostics
      • Memory Usage
      • SMART Drive Tools
      • System Information
    • Remote Desktop
    • SystemD
      • Delay Docker until after ZFS init
      • Documentation for SystemD
      • Show Service's Connections
    • Users & Groups
      • Adding New Users
  • Shells
    • Change Default Shell
      • macOS
    • Get Shell Information
    • Screen
    • Terminal Emulators
      • iTerm2
    • zsh
      • macOS Config
  • macOS
    • Hostname - macOS
    • Homebrew
      • Formulae (packages)
        • speedtest-cli
  • BASH
    • Check if File / Directory Exists
  • Docker
    • Docker Networking
    • Install Docker
      • Enable Memory Swappiness - Linux
    • Docker Compose
      • Environmental Variables for Compose
    • Docker Networking
    • Docker Commands
      • docker attach
  • Python
    • Virtual Environments
  • Web Services
    • DNS Records
      • DNS SPF Record
      • WHOIS - Lookup
    • Domain Parking
    • IANA Registered Ports & Services
Powered by GitBook
On this page
  • /etc/dnsmasq.d/
  • 01-pihole.conf
  • /etc/pihole/
  • adlists.list
  • auditlog.list
  • setupVars.conf
  1. Applications
  2. PiHole

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=

PreviousBlock ListsNextDNS over HTTPS

Last updated 4 years ago