diff --git a/settings-dns.lp b/settings-dns.lp index da85d16b..98395af5 100644 --- a/settings-dns.lp +++ b/settings-dns.lp @@ -57,38 +57,50 @@ mg.include('scripts/pi-hole/lua/settings_header.lp','r') -
The DNS domains for your Pi-hole. If no domain is specified and you are using Pi-hole's DHCP server, then any hostnames with a domain part (i.e., with a period) will be disallowed. If a domain is specified, then hostnames with a domain parts matching the domain here are allowed. In addition, when a suffix is set then hostnames without a domain part have the suffix added as an optional domain part.
+If set, the domain is added to simple names (without a period) in /etc/hosts in the same way as for DHCP-derived names.
+If not configured as your DHCP server, Pi-hole typically won't be able to - determine the names of devices on your local network. As a - result, tables such as Top Clients will only show IP addresses.
-One solution for this is to configure Pi-hole to forward these - requests to your DHCP server (most likely your router), but only for devices on your - home network. To configure this we will need to know the IP - address of your DHCP server and which addresses belong to your local network. - Exemplary input is given below as placeholder in the text boxes (if empty).
-If your local network spans 192.168.0.1 - 192.168.0.255, then you will have to input
- 192.168.0.0/24. If your local network is 192.168.47.1 - 192.168.47.255, it will
- be 192.168.47.0/24 and similar. If your network is larger, the CIDR has to be
- different, for instance a range of 10.8.0.1 - 10.8.255.255 results in 10.8.0.0/16,
- whereas an even wider network of 10.0.0.1 - 10.255.255.255 results in 10.0.0.0/8.
- Setting up IPv6 ranges is exactly similar to setting up IPv4 here and fully supported.
- Feel free to reach out to us on our
- Discourse forum
- in case you need any assistance setting up local host name resolution for your particular system.
You can also specify a local domain name (like fritz.box) to ensure queries to
- devices ending in your local domain name will not leave your network, however, this is optional.
- The local domain name must match the domain name specified
- in your DHCP server for this to work. You can likely find it within the DHCP settings.
Enabling Conditional Forwarding will also forward all hostnames (i.e., non-FQDNs) to the router - when "Never forward non-FQDNs" is not enabled.
-The following list contains all reverse servers you want to add. The expected format is one server per line in form of <enabled>,<ip-address>[/<prefix-len>],<server>[#<port>][,<domain>]. A valid config line could look like true,192.168.0.0/24,192.168.0.1,fritz.box
Block clients making more than queries within + seconds.
+When a client makes too many queries in too short time, it
+ gets rate-limited. Rate-limited queries are answered with a
+ REFUSED reply and not further processed by FTL
+ and prevent Pi-holes getting overwhelmed by rogue clients.
+ It is important to note that rate-limiting is happening on a
+ per-client basis. Other clients can continue to use FTL while
+ rate-limited clients are short-circuited at the same time.
Rate-limiting may be disabled altogether by setting both + values to zero. See + our documentation + for further details.
The DNS domains for your Pi-hole. If no domain is specified and you are using Pi-hole's DHCP server, then any hostnames with a domain part (i.e., with a period) will be disallowed. If a domain is specified, then hostnames with a domain parts matching the domain here are allowed. In addition, when a suffix is set then hostnames without a domain part have the suffix added as an optional domain part.
-If set, the domain is added to simple names (without a period) in /etc/hosts in the same way as for DHCP-derived names.
-Block clients making more than queries within - seconds.
-When a client makes too many queries in too short time, it
- gets rate-limited. Rate-limited queries are answered with a
- REFUSED reply and not further processed by FTL
- and prevent Pi-holes getting overwhelmed by rogue clients.
- It is important to note that rate-limiting is happening on a
- per-client basis. Other clients can continue to use FTL while
- rate-limited clients are short-circuited at the same time.
Rate-limiting may be disabled altogether by setting both - values to zero. See - our documentation - for further details.
+If not configured as your DHCP server, Pi-hole typically won't be able to + determine the names of devices on your local network. As a + result, tables such as Top Clients will only show IP addresses.
+One solution for this is to configure Pi-hole to forward these + requests to your DHCP server (most likely your router), but only for devices on your + home network. To configure this we will need to know the IP + address of your DHCP server and which addresses belong to your local network. + Exemplary input is given below as placeholder in the text boxes (if empty).
+If your local network spans 192.168.0.1 - 192.168.0.255, then you will have to input
+ 192.168.0.0/24. If your local network is 192.168.47.1 - 192.168.47.255, it will
+ be 192.168.47.0/24 and similar. If your network is larger, the CIDR has to be
+ different, for instance a range of 10.8.0.1 - 10.8.255.255 results in 10.8.0.0/16,
+ whereas an even wider network of 10.0.0.1 - 10.255.255.255 results in 10.0.0.0/8.
+ Setting up IPv6 ranges is exactly similar to setting up IPv4 here and fully supported.
+ Feel free to reach out to us on our
+ Discourse forum
+ in case you need any assistance setting up local host name resolution for your particular system.
You can also specify a local domain name (like fritz.box) to ensure queries to
+ devices ending in your local domain name will not leave your network, however, this is optional.
+ The local domain name must match the domain name specified
+ in your DHCP server for this to work. You can likely find it within the DHCP settings.
Enabling Conditional Forwarding will also forward all hostnames (i.e., non-FQDNs) to the router + when "Never forward non-FQDNs" is not enabled.
+The following list contains all reverse servers you want to add. The expected format is one server per line in form of <enabled>,<ip-address>[/<prefix-len>],<server>[#<port>][,<domain>]. A valid config line could look like true,192.168.0.0/24,192.168.0.1,fritz.box