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
pihole [2020/06/22 15:45]
Stephane de Labrusse
pihole [2020/08/06 09:58] (current)
Stephane de Labrusse [Upgrade]
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
  
 <WRAP center round tip 60%> <WRAP center round tip 60%>
-You must have a bridge, here called `br0`, if you have installed SAMBA AD, the it is already ​createdn else you can use the network panel to make it available.+You must have a bridge, here called `br0`, if you have installed SAMBA AD, then it is already ​created. Else you can use the network panel to make it available.
 </​WRAP>​ </​WRAP>​
  
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)
  
 ``` ```
 config setprop pihole piholeNetwork macvlan piholeMacVlanIP 192.168.1.234 config setprop pihole piholeNetwork macvlan piholeMacVlanIP 192.168.1.234
 ``` ```
 +=== Aeria ===
 +
 +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
 +<WRAP center round tip 60%>
 +You must have a bridge, here called `br0`, if you have installed SAMBA AD, then it is already created. Else you can use the network panel to make it available.
 +</​WRAP>​
 +
 +```
 +config setprop docker bridgeAeria br0
 +signal-event nethserver-docker-update
 +```
 +- check aeria is up : `docker network ls`
 +
 +- then assign `aeria` to piholeNetwork
 +
 +`config setprop pihole piholeNetwork aeria`
  
 === Create the container === === Create the container ===
Line 53: 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 63: 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 111: 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 127: 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
Line 134: Line 169:
 As many docker container the upgrade of a container means you must destroy it before As many docker container the upgrade of a container means you must destroy it before
  
-`pihole ​build`+`pihole ​upgrade`
  
-delete then build again the container+Upgrade the docker image, ​delete then build again the container
  
 +====Backup====
 +All the container data are in `/​var/​lib/​pihole`,​ it is included in the backup-data of your NethServer if used.
 ====Bugs==== ====Bugs====