2018-06-03 12:15:26 +00:00
.TH "pihole-FTL.conf" "5" "pihole-FTL.conf" "pihole-FTL.conf" "June 2018"
.SH "NAME"
pihole-FTL.conf - FTL's config file
.br
.SH "DESCRIPTION"
/etc/pihole/pihole-FTL.conf will be read by \fB pihole-FTL(8)\fR on startup.
.br
2018-06-03 23:54:53 +00:00
\fB SOCKET_LISTENING=localonly|all\fR
2018-06-03 12:15:26 +00:00
.br
Listen only for local socket connections or permit all connections
.br
2018-06-03 23:54:53 +00:00
\fB QUERY_DISPLAY=yes|no\fR
2018-06-03 12:15:26 +00:00
.br
Display all queries? Set to no to hide query display
.br
2018-06-03 23:54:53 +00:00
\fB AAAA_QUERY_ANALYSIS=yes|no\fR
2018-06-03 12:15:26 +00:00
.br
Allow FTL to analyze AAAA queries from pihole.log?
.br
2018-06-03 23:54:53 +00:00
\fB RESOLVE_IPV6=yes|no\fR
2018-06-03 12:15:26 +00:00
.br
2018-06-03 23:54:53 +00:00
Should FTL try to resolve IPv6 addresses to host names?
2018-06-03 12:15:26 +00:00
.br
2018-06-03 23:54:53 +00:00
\fB RESOLVE_IPV4=yes|no\fR
2018-06-03 12:15:26 +00:00
.br
2018-06-03 23:54:53 +00:00
Should FTL try to resolve IPv4 addresses to host names?
2018-06-03 12:15:26 +00:00
.br
2018-06-03 23:54:53 +00:00
\fB MAXDBDAYS=365\fR
2018-06-03 12:15:26 +00:00
.br
2018-06-03 23:54:53 +00:00
How long should queries be stored in the database?
.br
Setting this to 0 disables the database
2018-06-03 12:15:26 +00:00
.br
2018-06-03 23:54:53 +00:00
\fB DBINTERVAL=1.0\fR
2018-06-03 12:15:26 +00:00
.br
How often do we store queries in FTL's database [minutes]?
.br
2018-06-03 23:54:53 +00:00
\fB DBFILE=/etc/pihole/pihole-FTL.db\fR
2018-06-03 12:15:26 +00:00
.br
Specify path and filename of FTL's SQLite long-term database.
.br
Setting this to DBFILE= disables the database altogether
.br
2018-06-03 23:54:53 +00:00
\fB MAXLOGAGE=24.0\fR
2018-06-03 12:15:26 +00:00
.br
Up to how many hours of queries should be imported from the database and logs?
.br
Maximum is 744 (31 days)
.br
2018-06-03 23:54:53 +00:00
\fB FTLPORT=4711\fR
.br
On which port should FTL be listening?
.br
2020-10-13 22:53:23 +00:00
\fB PRIVACYLEVEL=0|1|2|3\fR
2018-06-03 23:54:53 +00:00
.br
Which privacy level is used?
.br
2018-06-05 00:25:51 +00:00
0 - show everything
.br
1 - hide domains
.br
2 - hide domains and clients
.br
2018-12-10 15:18:25 +00:00
3 - anonymous mode (hide everything)
.br
2018-06-03 23:54:53 +00:00
\fB IGNORE_LOCALHOST=no|yes\fR
.br
Should FTL ignore queries coming from the local machine?
.br
\fB BLOCKINGMODE=IP|IP-AAAA-NODATA|NXDOMAIN|NULL\fR
.br
How should FTL reply to blocked queries?
.br
2018-06-03 12:15:26 +00:00
For each setting, the option shown first is the default.
.br
.SH "SEE ALSO"
\fB pihole\fR (8), \fB pihole-FTL\fR (8)
.br
.SH "COLOPHON"
Pi-hole : The Faster-Than-Light (FTL) Engine is a lightweight, purpose-built daemon used to provide statistics needed for the Pi-hole Web Interface, and its API can be easily integrated into your own projects. Although it is an optional component of the Pi-hole ecosystem, it will be installed by default to provide statistics. As the name implies, FTL does its work \fI very quickly\fR !
.br
Get sucked into the latest news and community activity by entering Pi-hole's orbit. Information about Pi-hole, and the latest version of the software can be found at https://pi-hole.net
.br