From 2ebc7450bb20abb6a1bcfa8ed48a193f2eb2f9a9 Mon Sep 17 00:00:00 2001 From: DL6ER Date: Tue, 24 Jan 2017 13:28:06 +0100 Subject: [PATCH 1/2] Update Help --- help.php | 30 +++++++++++++++++++----------- 1 file changed, 19 insertions(+), 11 deletions(-) diff --git a/help.php b/help.php index 6af44722b..ac8d09785 100644 --- a/help.php +++ b/help.php @@ -70,25 +70,33 @@

White- / Blacklist

-

Add or remove domains (or subdomains) from the white-/blacklist. If a domain is added to e.g. the whitelist, any possible entry of the same domain will be automatically removed from the blacklist and vice versa. Adding wildcards using the web UI is currently not supported.

+

Add or remove domains (or subdomains) from the white-/blacklist. If a domain is added to e.g. the whitelist, any possible entry of the same domain will be automatically removed from the blacklist and vice versa.

+

Wildcard blacklisting is supported (entering something.de will block this domain including all subdomains like a.bb.c.999.something.de). Note that wildcard whitelisting is not supported.

+

You can white-/blacklist multiple entries at a time if you separate the domains by spaces.

-

Update Lists

-

Will download any updates from the third-party ad-serving domain lists that we source. By default, this command runs once a week via cron.

+

Disable / Enable

+ Disables/enables Pi-Hole blocking completely. You may have to wait a few minutes for the changes to reach all of your devices. The change will be reflected by a changed status (top left)
-

Query adlists

- This function is useful to find out what list a domain appears on. Since we don't control what the third-parties put on the block lists, you may find that a domain you normally visit stops working. If this is the case, you could run this command to scan for strings in the list of blocked domains and it will return the list the domain is found on. This proved useful a while back when the Mahakala list was adding apple.com and microsoft.com to their block list.

+

Tools → Update Lists

+

Will download any updates from the third-party ad-serving domain lists that we source. By default, this command runs once a week via cron (Sunday at 01:59).

-

Disable / Enable

- Disables/enables Pi-Hole blocking completely. You may have to wait a few minutes for the changes to reach all of your devices. The change will be reflected by a changed status (top left) +

Tools → Query adlists

+ This function is useful to find out what list a domain appears on. Since we don't control what the third-parties put on the block lists, you may find that a domain you normally visit stops working. If this is the case, you could run this command to scan for strings in the list of blocked domains and it will return the list the domain is found on. This proved useful a while back when the Mahakala list was adding apple.com and microsoft.com to their block list.

+
+
+
+
+

Tools → Tail pihole.log

+ Live tailing of the raw Pi-hole log.

@@ -96,13 +104,13 @@

Settings

Change settings for the Pi-Hole

Networking

- Displays information about the interfaces of the Pi-Hole. No changes possible + Displays information about the interfaces of the Pi-Hole. No changes possible.

Pi-Hole DHCP Server

- Using this setting you can enable/disable the DHCP server of the Pi-Hole. Note that you should disable any other DHCP server on your network to avoid IP addresses being used more than once. You have to give the range of IPs that DHCP will serve and the IP of the local router (gateway). If the DHCP server is active, the current leases are shown on the settings page. + Using this setting you can enable/disable the DHCP server of the Pi-Hole. Note that you should disable any other DHCP server on your network to avoid IP addresses being used more than once. You have to give the range of IPs that DHCP will serve and the IP of the local router (gateway). If the DHCP server is active, the current leases are shown on the settings page. IPv4 DHCP will always be activated, IPv6 (stateless + statefull) can be enabled.

Upstream DNS Servers

- Customize used upstream DNS servers + advanced settings + Customize used upstream DNS servers + advanced settings for DNS servers. Note that any number of DNS servers may be enabled at a time.

Query Logging

- Enabled/disable query logging on your Pi-hole + Enabled/disable query logging on your Pi-hole + provide option to flush the log

API

Change settings which apply to the API as well as the web UI
Note that Top Clients have to be given as IP addresses From ff3307f863a6b06a4170879a414a223a2be44b97 Mon Sep 17 00:00:00 2001 From: DL6ER Date: Tue, 24 Jan 2017 13:36:34 +0100 Subject: [PATCH 2/2] Small bug fix in help --- help.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/help.php b/help.php index ac8d09785..6f19ad604 100644 --- a/help.php +++ b/help.php @@ -51,7 +51,7 @@
  • and others
    • -
  • Query Types: Shows to which upstream DNS the permitted requests have been forwarded to.
    • +
  • Forward Destinations: Shows to which upstream DNS the permitted requests have been forwarded to.
  • Top Domains: Ranking of requested sites by number of DNS lookups.
  • Top Advertisers: Ranking of requested advertisements by number of DNS lookups.
  • Top Clients: Ranking of how many DNS requests each client has made on the local network.