Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
virtualisation:pihole_lxc_container [2022/05/23 13:20] – [Setup router] cakirvirtualisation:pihole_lxc_container [2025/04/29 07:18] (current) – [Setup LXC Pi-hole virtualization] dodenhoeft
Line 1: Line 1:
-====== Setup a Pi-hole in LXC container ====== +====== Pi-hole in LXC container ====== 
  
                                                                                                                                                                
Line 7: Line 7:
   *  **Setup router** to configure the DHCP server using pi-hole as DNS   *  **Setup router** to configure the DHCP server using pi-hole as DNS
  
-{{:virtualisation:pihole-logo.png|}}+{{ :virtualisation:pihole-logo.png  }}
 ===== Usecases of  Pi-hole ===== ===== Usecases of  Pi-hole =====
  
 Pi-hole can be used to block unwanted content on network level before it even reaches your browser. This is accomplished by using pi-hole as the primary DNS in your network. Every device that uses the router for internet access will benefit from this. By default the adlist will update automatically every sunday. Some of the key features of pi-hole are: Pi-hole can be used to block unwanted content on network level before it even reaches your browser. This is accomplished by using pi-hole as the primary DNS in your network. Every device that uses the router for internet access will benefit from this. By default the adlist will update automatically every sunday. Some of the key features of pi-hole are:
  
-  *  +  * Protection from adds and trackers 
-  * Protection from adds and trackers +  * Displaying statistical data about clients on the dashboard 
-  * Displaying statistical data about clients on the dashboard +  * Use as DHCP server for your network 
-  * Use as DHCP server for your network +  * Whitelist/Blacklist feature (supports filtering via regex) 
-  * Whitelist/Blacklist feature (supports filtering via regex) +  * Management of clients and groups of clients 
-  * Management of clients and groups of clients +  * Adding custom adlists and mangement of those
-  * Adding custom adlists and mangement of those+
  
 For a complete documentation of the full feature set you can visit https://docs.pi-hole.net/. For a complete documentation of the full feature set you can visit https://docs.pi-hole.net/.
Line 26: Line 25:
  
  
-===== Setup virtualization =====                       +===== Setup LXC Pi-hole virtualization ===== 
-                                                                                                    + 
 + 
 +<WRAP right round important 100%> 
 +The configuration has been accomplished and verifed with the following software versions: 
 + 
 +|Software version| 4.9.0.102| 
 +|Alpine version| 3.15.0| 
 +|Kernel version| 5.15.147| 
 + 
 +We will not take any responsiblity or support whether this configuration will work with different versions. 
 +</WRAP> 
 +                                                                                                  
 Before we can start please check if virtualization feature is licensed on your system (see SYSTEM -> Licensing on WebGUI). Before we can start please check if virtualization feature is licensed on your system (see SYSTEM -> Licensing on WebGUI).
  
Line 48: Line 58:
  
  
-===== Setup router =====+===== Setup router DHCP/DNS =====
                                                                                                                                            
 We are now back at the router Web-GUI to do the final setup of the DHCP server and DNS settings.                            We are now back at the router Web-GUI to do the final setup of the DHCP server and DNS settings.                           
Line 64: Line 74:
 {{:virtualisation:03-pihole-reboot.png}} {{:virtualisation:03-pihole-reboot.png}}
                                                                                                                                                                                                          
-**Step 4:** To verify that everything is working correctly open then pi-hole web interface by visiting ''http://192.168.1.111/admin/'' with your browser. The default admin password after installation is "admin01". **We strongly recommend to change the password after verifying sucessfull installation.** (see next step)+**Step 4:** To verify that everything is working correctly open then pi-hole web interface login page by visiting ''http://192.168.1.111/admin/index.php?login'' with your browser. The default admin password after installation is "admin01". **We strongly recommend to change the password after verifying sucessfull installation.** (see next step)
  
 {{:virtualisation:04-pihole-gui.png}} {{:virtualisation:04-pihole-gui.png}}
  
-**Step 5:** To change the password we need to access the router via terminal. Log in via ssh, telnet or serial connection and then run the command "''lxc-attach guest0''"" then run the command for changing the password "''pihole -a -p''"+**Step 5:** To change the password we need to access the router with command line interface. Log in via ssh, telnet or serial connection and then run the command "''lxc-attach guest0''"" to enter the shell in LXC, then run the command "''pihole -a -p''" for changing the password
  
 {{:virtualisation:05-pihole-gui.png}} {{:virtualisation:05-pihole-gui.png}}
  
-**The installation is finished and Pi-hole is now in working condition.** You can access the webgui (192.168.1.111any time and view the dashboard or login to adjust settings. +**The installation is finished and Pi-hole is now in working condition.** You can access the webgui on ''192.168.1.111'' any time and view the dashboard or login to adjust settings.                                                                                                   
- +
- +
- +
- +
- +
- +
-                                                                                                    +