From abf58f17ef37d9fb23deb010649710d87b59de49 Mon Sep 17 00:00:00 2001 From: DL6ER Date: Wed, 6 Oct 2021 08:19:21 +0200 Subject: [PATCH 1/3] Add PIHOLE_PTR=HOSTNAMEFQDN documentation Signed-off-by: DL6ER --- docs/ftldns/configfile.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/ftldns/configfile.md b/docs/ftldns/configfile.md index 565a419..4e17231 100644 --- a/docs/ftldns/configfile.md +++ b/docs/ftldns/configfile.md @@ -142,6 +142,7 @@ Controls whether and how FTL will reply with for address for which a local inter - `PI.HOLE` (the default) respond with `pi.hole` - `HOSTNAME` serve the machine's global hostname +- `HOSTNAMEFQDN` serve the machine's global hostname as fully qualified domain by adding the local suffix. If no local suffix has been defined, FTL appends `.fqdn` - `NONE` Pi-hole will **not** respond automatically on PTR requests to local interface addresses. Ensure `pi.hole` and/or hostname records exist elsewhere. #### `DELAY_STARTUP=0` (PR [#716](https://github.com/pi-hole/FTL/pull/716)) {#delay_startup data-toc-label='Delay resolver startup'} From cc5c1990e777481c67e62b0b24d38165c577c0bf Mon Sep 17 00:00:00 2001 From: DL6ER Date: Fri, 8 Oct 2021 09:13:37 +0200 Subject: [PATCH 2/3] Add note about why users see .no_fqdn_available when no local suffix is defined. Signed-off-by: DL6ER --- docs/ftldns/configfile.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/ftldns/configfile.md b/docs/ftldns/configfile.md index 4e17231..bf1df56 100644 --- a/docs/ftldns/configfile.md +++ b/docs/ftldns/configfile.md @@ -142,9 +142,11 @@ Controls whether and how FTL will reply with for address for which a local inter - `PI.HOLE` (the default) respond with `pi.hole` - `HOSTNAME` serve the machine's global hostname -- `HOSTNAMEFQDN` serve the machine's global hostname as fully qualified domain by adding the local suffix. If no local suffix has been defined, FTL appends `.fqdn` +- `HOSTNAMEFQDN` serve the machine's global hostname as fully qualified domain by adding the local suffix. See note below. - `NONE` Pi-hole will **not** respond automatically on PTR requests to local interface addresses. Ensure `pi.hole` and/or hostname records exist elsewhere. +Note about `HOSTNAMEFQDN`: If no local suffix has been defined, FTL appends the local domain `.no_fqdn_available`. In this case you should either add `domain=whatever.com` (to set `whatever.com` as local domain) or use `domain=#` which will try to derive the local domain from `/etc/resolv.conf` (or whatever is set with `resolv-file`, when multiple `search` directives exist, the first one is used). + #### `DELAY_STARTUP=0` (PR [#716](https://github.com/pi-hole/FTL/pull/716)) {#delay_startup data-toc-label='Delay resolver startup'} In certain configurations, you may want FTL to wait a given amount of time before trying to start the DNS revolver. This is typically found when network interfaces appear only late during system startup and the interface startup priorities are configured incorrectly. This setting takes any integer value between 0 and 300 seconds. From 8899989d72bb8694dcd0199249f44b1b49525b1d Mon Sep 17 00:00:00 2001 From: DL6ER Date: Tue, 26 Oct 2021 17:07:47 +0200 Subject: [PATCH 3/3] Clarify where to add the domain= setting Signed-off-by: DL6ER --- docs/ftldns/configfile.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ftldns/configfile.md b/docs/ftldns/configfile.md index bf1df56..9831ed6 100644 --- a/docs/ftldns/configfile.md +++ b/docs/ftldns/configfile.md @@ -145,7 +145,7 @@ Controls whether and how FTL will reply with for address for which a local inter - `HOSTNAMEFQDN` serve the machine's global hostname as fully qualified domain by adding the local suffix. See note below. - `NONE` Pi-hole will **not** respond automatically on PTR requests to local interface addresses. Ensure `pi.hole` and/or hostname records exist elsewhere. -Note about `HOSTNAMEFQDN`: If no local suffix has been defined, FTL appends the local domain `.no_fqdn_available`. In this case you should either add `domain=whatever.com` (to set `whatever.com` as local domain) or use `domain=#` which will try to derive the local domain from `/etc/resolv.conf` (or whatever is set with `resolv-file`, when multiple `search` directives exist, the first one is used). +Note about `HOSTNAMEFQDN`: If no local suffix has been defined, FTL appends the local domain `.no_fqdn_available`. In this case you should either add `domain=whatever.com` to a custom config file inside `/etc/dnsmasq.d/` (to set `whatever.com` as local domain) or use `domain=#` which will try to derive the local domain from `/etc/resolv.conf` (or whatever is set with `resolv-file`, when multiple `search` directives exist, the first one is used). #### `DELAY_STARTUP=0` (PR [#716](https://github.com/pi-hole/FTL/pull/716)) {#delay_startup data-toc-label='Delay resolver startup'}