Skip to content

Configuration

You can create a file /etc/pihole/pihole-FTL.conf that will be read by FTLDNS on startup.

Possible settings (the option shown first is the default):

DNS settings

BLOCKINGMODE=NULL|IP-NODATA-AAAA|IP|NXDOMAIN

How should FTL reply to blocked queries?
More details

Statistics settings

MAXLOGAGE=24.0

Up to how many hours of queries should be imported from the database and logs? Maximum is 24.0


PRIVACYLEVEL=0|1|2|3|4

Which privacy level is used?
More details


IGNORE_LOCALHOST=no|yes

Should FTL ignore queries coming from the local machine?


AAAA_QUERY_ANALYSIS=yes|no

Allow FTL to analyze AAAA queries from pihole.log?


ANALYZE_ONLY_A_AND_AAAA=false|true

Should FTL only analyze A and AAAA queries?

Socket settings

SOCKET_LISTENING=localonly|all

Listen only for local socket connections or permit all connections


FTLPORT=4711

On which port should FTL be listening?

Host name resolution

RESOLVE_IPV6=yes|no

Should FTL try to resolve IPv6 addresses to host names?


RESOLVE_IPV4=yes|no

Should FTL try to resolve IPv4 addresses to host names?

Database settings

Further details concerning the database

DBIMPORT=yes|no

Should FTL load information from the database on startup to be aware of the most recent history?


MAXDBDAYS=365

How long should queries be stored in the database? Setting this to 0 disables the database


DBINTERVAL=1.0

How often do we store queries in FTL's database [minutes]?


DBFILE=/etc/pihole/pihole-FTL.db

Specify path and filename of FTL's SQLite3 long-term database. Setting this to DBFILE= disables the database altogether

Debugging options

REGEX_DEBUGMODE=false|true

Controls if FTLDNS should print extended details about regex matching into pihole-FTL.log.
More details