Pi-Hole/docs
1
0
Fork 0
mirror of https://github.com/pi-hole/docs.git synced 2025-12-20 03:08:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update configfile.md

Browse Source 
Signed-off-by: Adam Warner <me@adamwarner.co.uk>
This commit is contained in:
Adam Warner
2025-12-12 23:18:45 +00:00
parent 5b460f463f
commit 3a7ca609ee
1 changed files with 74 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

127
docs/ftldns/configfile.md
View File

@@ -53,16 +53,19 @@ Array of IP addresses and/or hostnames, optionally with a port (#...)
=== "TOML" === "TOML"
```toml ```toml
[dns] [dns]
upstreams = [] upstreams = [ "8.8.8.8", "127.0.0.1#5335", "docker-resolver" ]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dns.upstreams [] sudo pihole-FTL --config dns.upstreams '[ "8.8.8.8", "127.0.0.1#5335", "docker-resolver" ]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dns_upstreams: [] FTLCONF_dns_upstreams: |-
8.8.8.8
127.0.0.1#5335
docker-resolver
``` ```
### `CNAMEdeepInspect` ### `CNAMEdeepInspect`
@@ -353,16 +356,18 @@ Array of custom DNS records each one in HOSTS form: `"IP HOSTNAME [HOSTNAME ...]
=== "TOML" === "TOML"
```toml ```toml
[dns] [dns]
hosts = [] hosts = [ "127.0.0.1 mylocal", "192.168.0.1 therouter" ]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dns.hosts [] sudo pihole-FTL --config dns.hosts '[ "127.0.0.1 mylocal", "192.168.0.1 therouter" ]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dns_hosts: [] FTLCONF_dns_hosts: |-
127.0.0.1 mylocal
192.168.0.1 therouter
``` ```
### `domainNeeded` ### `domainNeeded`
@@ -506,16 +511,16 @@ A string in the format
=== "TOML" === "TOML"
```toml ```toml
[dns] [dns]
hostRecord = "" hostRecord = "laptop,laptop.lan,192.168.0.1,1234::100"
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dns.hostRecord "" sudo pihole-FTL --config dns.hostRecord "laptop,laptop.lan,192.168.0.1,1234::100"
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dns_hostRecord: '' FTLCONF_dns_hostRecord: 'laptop,laptop.lan,192.168.0.1,1234::100'
``` ```
### `listeningMode` ### `listeningMode`
@@ -617,7 +622,7 @@ Array of CNAMEs, each one in the following form: `"<cname>,<target>[,<TTL>]"`
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dns.cnameRecords [] sudo pihole-FTL --config dns.cnameRecords '[]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
@@ -715,16 +720,17 @@ want here.
=== "TOML" === "TOML"
```toml ```toml
[dns] [dns]
revServers = [] revServers = [ "true,192.168.0.0/24,192.168.0.1,fritz.box" ]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dns.revServers [] sudo pihole-FTL --config dns.revServers '[ "true,192.168.0.0/24,192.168.0.1,fritz.box" ]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dns_revServers: [] FTLCONF_dns_revServers: |-
true,192.168.0.0/24,192.168.0.1,fritz.box
``` ```
@@ -1436,16 +1442,16 @@ A valid IPv4 address, or empty string (`""`)
=== "TOML" === "TOML"
```toml ```toml
[dhcp] [dhcp]
start = "" start = "192.168.0.10"
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dhcp.start "" sudo pihole-FTL --config dhcp.start "192.168.0.10"
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dhcp_start: '' FTLCONF_dhcp_start: '192.168.0.10'
``` ```
### `end` ### `end`
@@ -1462,16 +1468,16 @@ A valid IPv4 address, or empty string (`""`)
=== "TOML" === "TOML"
```toml ```toml
[dhcp] [dhcp]
end = "" end = "192.168.0.250"
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dhcp.end "" sudo pihole-FTL --config dhcp.end "192.168.0.250"
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dhcp_end: '' FTLCONF_dhcp_end: '192.168.0.250'
``` ```
### `router` ### `router`
@@ -1489,16 +1495,16 @@ A valid IPv4 address, or empty string (`""`)
=== "TOML" === "TOML"
```toml ```toml
[dhcp] [dhcp]
router = "" router = "192.168.0.1"
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dhcp.router "" sudo pihole-FTL --config dhcp.router "192.168.0.1"
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dhcp_router: '' FTLCONF_dhcp_router: '192.168.0.1'
``` ```
### `netmask` ### `netmask`
@@ -1522,16 +1528,16 @@ Any valid netmask, or an empty string (`""`) for auto-discovery
=== "TOML" === "TOML"
```toml ```toml
[dhcp] [dhcp]
netmask = "" netmask = "255.255.255.0"
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dhcp.netmask "" sudo pihole-FTL --config dhcp.netmask "255.255.255.0"
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dhcp_netmask: '' FTLCONF_dhcp_netmask: '255.255.255.0'
``` ```
### `leaseTime` ### `leaseTime`
@@ -1718,16 +1724,19 @@ Array of static leases each one in the following form:
=== "TOML" === "TOML"
```toml ```toml
[dhcp] [dhcp]
hosts = [] hosts = [ "00:20:e0:3b:13:af,192.168.0.123,laptop,24h",
"00:20:e0:ab:cd:ef,192.168.0.124,desktop,24h"]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config dhcp.hosts [] sudo pihole-FTL --config dhcp.hosts '["00:20:e0:3b:13:af,192.168.0.123,laptop,24h","00:20:e0:ab:cd:ef,192.168.0.124,desktop,24h"]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_dhcp_hosts: [] FTLCONF_dhcp_hosts: |-
00:20:e0:3b:13:af,192.168.0.123,laptop,24h
00:20:e0:ab:cd:ef,192.168.0.124,desktop,24h
``` ```
@@ -1974,16 +1983,16 @@ A valid RTC device path, or empty string (`""`) for auto-discovery
=== "TOML" === "TOML"
```toml ```toml
[ntp.sync.rtc] [ntp.sync.rtc]
device = "" device = "/dev/rtc0"
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config ntp.sync.rtc.device "" sudo pihole-FTL --config ntp.sync.rtc.device "/dev/rtc0"
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_ntp_sync_rtc_device: '' FTLCONF_ntp_sync_rtc_device: '/dev/rtc0'
``` ```
### `utc` ### `utc`
@@ -2525,15 +2534,13 @@ An array of HTTP headers
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_webserver_headers: | FTLCONF_webserver_headers: |-
[ X-DNS-Prefetch-Control: off
'X-DNS-Prefetch-Control: off', Content-Security-Policy: default-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:;
'Content-Security-Policy: default-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:;', X-Frame-Options: DENY
'X-Frame-Options: DENY', X-XSS-Protection: 0
'X-XSS-Protection: 0', X-Content-Type-Options: nosniff
'X-Content-Type-Options: nosniff', Referrer-Policy: strict-origin-when-cross-origin
'Referrer-Policy: strict-origin-when-cross-origin'
]
``` ```
### `serve_all` ### `serve_all`
@@ -2587,16 +2594,18 @@ An array of valid CivetWeb options
=== "TOML" === "TOML"
```toml ```toml
[webserver] [webserver]
advancedOpts = [] advancedOpts = [ "ssl_protocol_version=4", "ssl_cipher_list=AES128:!MD5" ]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config webserver.advancedOpts [] sudo pihole-FTL --config webserver.advancedOpts '[ "ssl_protocol_version=4", "ssl_cipher_list=AES128:!MD5" ]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_webserver_advancedOpts: [] FTLCONF_webserver_advancedOpts: |-
ssl_protocol_version=4
ssl_cipher_list=AES128:!MD5
``` ```
@@ -3109,16 +3118,19 @@ An array of regular expressions describing clients
=== "TOML" === "TOML"
```toml ```toml
[webserver.api] [webserver.api]
excludeClients = [] excludeClients = [ "^192\\.168\\.2\\.56$", "^fe80::341:[0-9a-f]*$", "^localhost$" ]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config webserver.api.excludeClients [] sudo pihole-FTL --config webserver.api.excludeClients '[ "^192\\.168\\.2\\.56$", "^fe80::341:[0-9a-f]*$", "^localhost$" ]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_webserver_api_excludeClients: [] FTLCONF_webserver_api_excludeClients: |-
^192\\.168\\.2\\.56$
^fe80::341:[0-9a-f]*$
^localhost$
``` ```
### `excludeDomains` ### `excludeDomains`
@@ -3139,16 +3151,18 @@ An array of regular expressions describing domains
=== "TOML" === "TOML"
```toml ```toml
[webserver.api] [webserver.api]
excludeDomains = [] excludeDomains = [ "(^|\\.)\\.google\\.de$", "\\.pi-hole\\.net$" ]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config webserver.api.excludeDomains [] sudo pihole-FTL --config webserver.api.excludeDomains '[ "(^|\\.)\\.google\\.de$", "\\.pi-hole\\.net$" ]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_webserver_api_excludeDomains: [] FTLCONF_webserver_api_excludeDomains: |-
(^|\\.)\\.google\\.de$
\\.pi-hole\\.net$
``` ```
### `maxHistory` ### `maxHistory`
@@ -3715,6 +3729,9 @@ from working.
Use this option with extra care. Use this option with extra care.
**Example:** `[ "address=/example.com/192.168.0.1", "address=/example.org/192.168.0.2",
"address=/example.net/192.168.0.3" ]`
**Allowed values are:** **Allowed values are:**
Array of valid dnsmasq config line options Array of valid dnsmasq config line options
@@ -3723,16 +3740,20 @@ Array of valid dnsmasq config line options
=== "TOML" === "TOML"
```toml ```toml
[misc] [misc]
dnsmasq_lines = [] dnsmasq_lines = [ "address=/example.com/192.168.0.1", "address=/example.org/192.168.0.2",
"address=/example.net/192.168.0.3" ]
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config misc.dnsmasq_lines [] sudo pihole-FTL --config misc.dnsmasq_lines '["address=/example.com/192.168.0.1","address=/example.org/192.168.0.2","address=/example.net/192.168.0.3"]'
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml
environment: environment:
FTLCONF_misc_dnsmasq_lines: [] FTLCONF_misc_dnsmasq_lines: |-
address=/example.com/192.168.0.1
address=/example.org/192.168.0.2
address=/example.net/192.168.0.3
``` ```
### `extraLogging` ### `extraLogging`
@@ -4066,7 +4087,7 @@ true or false
``` ```
=== "CLI" === "CLI"
```shell ```shell
sudo pihole-FTL --config debug.flags alse sudo pihole-FTL --config debug.flags false
``` ```
=== "Environment (Docker Compose)" === "Environment (Docker Compose)"
```yaml ```yaml