From 36d73b2a6cb8ce111319c2f4188f9929a587b2a5 Mon Sep 17 00:00:00 2001 From: Bob Mottram Date: Tue, 22 Aug 2017 10:51:03 +0100 Subject: [PATCH] Note about hosts file for pi-hole --- doc/EN/app_pihole.org | 9 ++++++-- website/EN/app_pihole.html | 44 ++++++++++++++++++++++---------------- 2 files changed, 33 insertions(+), 20 deletions(-) diff --git a/doc/EN/app_pihole.org b/doc/EN/app_pihole.org index 92b9dd7a..24bf68c9 100644 --- a/doc/EN/app_pihole.org +++ b/doc/EN/app_pihole.org @@ -32,11 +32,17 @@ When that's done select *About this system* from the control panel and see the I * On each client system within your local network +Make sure that you add the static IP address for the server to */etc/hosts*. + +#+begin_src bash +STATIC_IP=[your server static IP] +sudo echo "$STATIC_IP [your domain name]" >> /etc/hosts +#+end_src + On Arch/Parabola: #+begin_src bash sudo pacman -S openresolv -STATIC_IP=[your server static IP] sudo sed -i "s|#name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf sudo sed -i "s|name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf sudo chattr -i /etc/resolv.conf @@ -47,7 +53,6 @@ Or on a Debian based system: #+begin_src bash sudo apt-get install resolvconf -STATIC_IP=[your server static IP] echo 'domain localdomain' > /tmp/resolvconf echo 'search localdomain' >> /tmp/resolvconf echo "nameserver $STATIC_IP" >> /tmp/resolvconf diff --git a/website/EN/app_pihole.html b/website/EN/app_pihole.html index c61ed6b2..65a57a41 100644 --- a/website/EN/app_pihole.html +++ b/website/EN/app_pihole.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + @@ -264,9 +264,9 @@ You can block ads for any devices connected to your local network by installing Also don't expect perfection. Though many ads may be blocked by this system some will still get through. It's a constant cat and mouse game between advertisers and blockers.

-
-

Set a static IP address

-
+
+

Set a static IP address

+

Ensure that your system has a static local IP address (typically 192.168..) using the option on the control panel. You will also need to know the IP address of your internet router, which is usually 192.168.1.1 or 192.168.1.254.

@@ -277,16 +277,25 @@ When that's done select About this system from the control panel and see
-
-

On each client system within your local network

-
+
+

On each client system within your local network

+
+

+Make sure that you add the static IP address for the server to /etc/hosts. +

+ +
+
STATIC_IP=[your server static IP]
+sudo echo "$STATIC_IP [your domain name]" >> /etc/hosts
+
+
+

On Arch/Parabola: 

sudo pacman -S openresolv
-STATIC_IP=[your server static IP]
 sudo sed -i "s|#name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf
 sudo sed -i "s|name_servers=.*|name_servers=$STATIC_IP|g" /etc/resolvconf.conf
 sudo chattr -i /etc/resolv.conf
@@ -300,7 +309,6 @@ Or on a Debian based system:
 
 

 
sudo apt-get install resolvconf
-STATIC_IP=[your server static IP]
 echo 'domain localdomain' > /tmp/resolvconf
 echo 'search localdomain' >> /tmp/resolvconf
 echo "nameserver $STATIC_IP" >> /tmp/resolvconf
@@ -312,9 +320,9 @@ sudo resolvconf -u
-
-

On your internet router

-
+
+

On your internet router

+

If you can access the settings on your local internet router then this is the simplest way to provide ad blocking for all devices which connect to it. Unfortunately some router models don't let you edit the DNS settings and if that's the case you might want to consider getting a different router.

@@ -324,9 +332,9 @@ Edit the DNS settings and add the IPv4 address which you got from the control pa

-
-

LibreCMC

-
+
+

LibreCMC

+

On a router running LibreCMC from the Network menu select DHCP and DNS. Enter the static IP address of your Freedombone system within DNS Forwardings, then at the bottom of the page click on Save & Apply. Any devices which connect to your router will now have ad blocking.

@@ -334,9 +342,9 @@ On a router running LibreCMC from the Network menu select DHCP and DNS
-
-

Configuring block lists

-
+
+

Configuring block lists

+

You can configure the block lists which the system uses by going to the administrator control panel, selecting App Settings then choosing pihole. You can also add any extra domain names to the whitelist if they're being wrongly blocked or to the blacklist if they're not blocked by the current lists.