Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
pihole [2020/06/22 15:58]
Stephane de Labrusse
pihole [2020/08/06 09:53]
Stephane de Labrusse [Pihole wrapper]
Line 22: Line 22:
  
 ===Macvlan=== ===Macvlan===
 +if you have decided to use the `aeria network`, please jump to the next [[pihole#​aeria|chapter]] ​
  
 Macvlan is particuliar network, this is the documentation for explanation,​ please refer there to understand: https://​github.com/​NethServer/​nethserver-docker/​blob/​master/​README.rst#​macvlan Macvlan is particuliar network, this is the documentation for explanation,​ please refer there to understand: https://​github.com/​NethServer/​nethserver-docker/​blob/​master/​README.rst#​macvlan
Line 35: Line 36:
  
 - check macvlan is up : `docker network ls` - check macvlan is up : `docker network ls`
-- then assign `macvlan` to piholeNetwork and set the IP to `piholeMacVlanIP` (in macvlan range)+- then assign `macvlan` to `piholeNetworkand set the IP to `piholeMacVlanIP` (in macvlan range)
  
 ``` ```
Line 42: Line 43:
 === Aeria === === Aeria ===
  
-if you have decided to use the macvlan network, please jump to the next [[pihole|chapter]] ​+if you have decided to use the `macvlan network`, please jump to the next [[pihole#​create_the_container|chapter]] ​ 
 To create the AERIA network please review https://​github.com/​NethServer/​nethserver-docker/​blob/​master/​README.rst#​aeria-network To create the AERIA network please review https://​github.com/​NethServer/​nethserver-docker/​blob/​master/​README.rst#​aeria-network
 <WRAP center round tip 60%> <WRAP center round tip 60%>
Line 70: Line 72:
     piholeMacVlanIP=192.168.1.234     piholeMacVlanIP=192.168.1.234
     piholeNetwork=macvlan     piholeNetwork=macvlan
- 
     timezone=UTC     timezone=UTC
 ``` ```
  
 - change the admin password (default is `admin`) - change the admin password (default is `admin`)
 +
 By default the password is admin, you should change it obviously, once created with a password, you must destroy the container, change the password and create it again. By default the password is admin, you should change it obviously, once created with a password, you must destroy the container, change the password and create it again.
  
Line 80: Line 82:
  
  
-- Modify the upstream DNS of pihole following your needs, it can be used (default is google DNS)+- Modify the upstream DNS of pihole following your needs (default is google DNS)
  
-you can adjust to different ​dns if you think they are faster or DNS with adult filtering if your want to protect your kids+you can adjust to different ​DNS if you think they are faster or DNS with adult filtering if your want to protect your kids
  
-as example I will use cleanbrowsing.org,​ decide what Family or Adult filter to use+as example I will use cleanbrowsing.org,​ decide what Family or Adult filter to use (https://​cleanbrowsing.org/​ip-address)
  
-If you want to filter porn, set DNS1 and DNS2 to https://​cleanbrowsing.org/​ip-address+If you want to filter porn, set DNS1 and DNS2 to 
  
 ``` ```
Line 128: Line 130:
 ==== Where to start ==== ==== Where to start ====
  
-Once installed ​dolibarr ​is available at the ip of the container, to find it do `pihole ip` in the terminal, use the IP of the container in your browser, then log with the credential `admin` and the password set in the `password` esmith property +Once installed ​pihole ​is available at the ip of the container, to find it do `pihole ip` in the terminal, use the IP of the container in your browser, then log with the credential `admin` and the password set in the `password` esmith property 
-==== pihole ​wrapper ====+ 
 + 
 +====Making devices use Pi-hole==== 
 +To use Pi-Hole, make sure that your devices use Pi-Hole'​s IP address as their only DNS server. To accomplish this, there are generally 2 methods to make it happen: 
 + 
 +  - In router'​s LAN DHCP settings, set Pi-Hole'​s IP address as the only DNS server available for connected devices. 
 +  - Manually configure each device to use Pi-Hole'​s IP address as their only DNS server. 
 + 
 +Note: Some routers (or even ISPs) do not allow to change LAN DNS settings, so you might want to disable router'​s DHCP server and use the NetHServer built in DHCP server instead. 
 +More information about making other devices use Pi-Hole can be found at [[https://​discourse.pi-hole.net/​t/​how-do-i-configure-my-devices-to-use-pi-hole-as-their-dns-server/​245|upstream documentation.]] 
 + 
 +<WRAP center round important 60%> 
 +Some router can still serve DNS request when the IPV6 is enabled, you should turn it off because we do not use yet with NethServer. I mean the livebox4 of orange for example 
 +</​WRAP>​ 
 + 
 +==== Pihole ​wrapper ====
  
-do `pihole` in your container ​to get help+do `pihole` in your terminal ​to get help
  
 pihole facilities wrapper to docker command pihole facilities wrapper to docker command
Line 144: Line 161:
     pihole destroy: Delete the pihole container     pihole destroy: Delete the pihole container
     pihole build: Delete then create the pihole container     pihole build: Delete then create the pihole container
 +    pihole upgrade: Upgrade docker image, delete then create the pihole container
     pihole ps: Container information     pihole ps: Container information
     pihole log: Display the error log of the container     pihole log: Display the error log of the container