mirror of
https://github.com/pi-hole/docs.git
synced 2025-12-19 18:58:42 +00:00
86
docs/ftldns/configfile.md
Normal file
86
docs/ftldns/configfile.md
Normal file
@@ -0,0 +1,86 @@
|
||||
You can create a file `/etc/pihole/pihole-FTL.conf` that will be read by *FTL*DNS on startup.
|
||||
|
||||
Possible settings (**the option shown first is the default**):
|
||||
|
||||
### SOCKET_LISTENING
|
||||
`SOCKET_LISTENING=localonly|all`
|
||||
|
||||
Listen only for local socket connections or permit all connections
|
||||
|
||||
### QUERY_DISPLAY
|
||||
`QUERY_DISPLAY=yes|no`
|
||||
|
||||
Display all queries? Set to `no` to hide query display
|
||||
|
||||
### AAAA_QUERY_ANALYSIS
|
||||
`AAAA_QUERY_ANALYSIS=yes|no`
|
||||
|
||||
Allow `FTL` to analyze AAAA queries from pihole.log?
|
||||
|
||||
### RESOLVE_IPV6
|
||||
`RESOLVE_IPV6=yes|no`
|
||||
|
||||
Should `FTL` try to resolve IPv6 addresses to host names?
|
||||
|
||||
### RESOLVE_IPV4
|
||||
`RESOLVE_IPV4=yes|no`
|
||||
|
||||
Should `FTL` try to resolve IPv4 addresses to host names?
|
||||
|
||||
### MAXDBDAYS
|
||||
`MAXDBDAYS=365`
|
||||
|
||||
How long should queries be stored in the database?
|
||||
Setting this to `0` disables the database
|
||||
|
||||
**[More details](database.md)**
|
||||
|
||||
### DBINTERVAL
|
||||
`DBINTERVAL=1.0`
|
||||
|
||||
How often do we store queries in FTL's database [minutes]?
|
||||
|
||||
**[More details](database.md)**
|
||||
|
||||
### DBFILE
|
||||
`DBFILE=/etc/pihole/pihole-FTL.db`
|
||||
|
||||
Specify path and filename of FTL's SQLite long-term database. Setting this to `DBFILE=` disables the database altogether
|
||||
|
||||
**[More details](database.md)**
|
||||
|
||||
### MAXLOGAGE
|
||||
`MAXLOGAGE=24.0`
|
||||
|
||||
Up to how many hours of queries should be imported from the database and logs? Maximum is 744 (31 days)
|
||||
|
||||
### FTLPORT
|
||||
`FTLPORT=4711`
|
||||
|
||||
On which port should FTL be listening?
|
||||
|
||||
### PRIVACYLEVEL
|
||||
`PRIVACYLEVEL=0|1|2|3`
|
||||
|
||||
Which privacy level is used?
|
||||
|
||||
**[More details](privacylevels.md)**
|
||||
|
||||
### IGNORE_LOCALHOST
|
||||
`IGNORE_LOCALHOST=no|yes`
|
||||
|
||||
Should `FTL` ignore queries coming from the local machine?
|
||||
|
||||
### BLOCKINGMODE
|
||||
`BLOCKINGMODE=IP|NXDOMAIN`
|
||||
|
||||
Should `FTL` reply queries to blocked domains with IPs or `NXDOMAIN`?
|
||||
|
||||
**[More details](blockingmode.md)**
|
||||
|
||||
### BLOCKINGREGEX
|
||||
`BLOCKINGREGEX=...`
|
||||
|
||||
If defined, `FTL` will block all incoming queries which match this RegEx.
|
||||
|
||||
**[More details](regex.md)**
|
||||
@@ -26,6 +26,7 @@ pages:
|
||||
- 'Updating': 'main/update.md'
|
||||
- 'FTLDNS':
|
||||
- 'Overview': "ftldns/index.md"
|
||||
- 'Configuration': "ftldns/configfile.md"
|
||||
- 'Blocking mode': "ftldns/blockingmode.md"
|
||||
- 'RegEx blocking': "ftldns/regex.md"
|
||||
# - 'Privacy levels': "ftldns/privacy.md"
|
||||
|
||||
Reference in New Issue
Block a user