This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
virtualisation:pihole_lxc_container [2022/05/12 13:21] – [Advanced Installagion Guide] cakir | virtualisation:pihole_lxc_container [2022/05/24 09:27] – [Setup router] cakir | ||
---|---|---|---|
Line 2: | Line 2: | ||
- | In this guide we will describe the steps is necessary to install and setup a working pi-hole inside a LXC container on a NetModule router. The guide will be divided into 2 sections. At the bottom there is some optionsal additional information for installing Pi-hole manually from scratch. | + | In this guide we will describe the steps necessary to install and setup a working pi-hole inside a LXC container on a NetModule router. The guide will be divided into 2 sections. |
* | * | ||
- | * **Setup virtualization** | + | * **Setup virtualization** |
- | * **Setup router** | + | * **Setup router** |
- | + | ||
- | If you would like to do a Manual install replace step 3 of section **Setup virtualiszation** with the Advanced Manual Install guide for Pi-hole below. The other Steps of the main guide are still necessary. | + | |
{{: | {{: | ||
===== 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. By default the default | + | 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 |
* | * | ||
* 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 it as DHCP server for your network | + | * Use as DHCP server for your network |
* Whitelist/ | * Whitelist/ | ||
* Management of clients and groups of clients | * Management of clients and groups of clients | ||
Line 27: | Line 25: | ||
- | ====== Basic Installation Guide ====== | ||
===== Setup virtualization ===== | ===== Setup virtualization ===== | ||
Line 38: | Line 35: | ||
**Step 1:** First we need a working WAN connecton to the Internet. Make sure DNS names get resolved correctly. | **Step 1:** First we need a working WAN connecton to the Internet. Make sure DNS names get resolved correctly. | ||
| | ||
- | **Step 2:** On the Web-GUI navigate to SYSTEM -> Virtualization and click the small plus icon to create a new virtualization. Here we navigate to the Networking tab and pick bridged. We leave the interface at LAN1 and click the Apply button. | + | **Step 2:** On the Web-GUI navigate to SYSTEM -> Virtualization and click the small plus icon to create a new virtualization. Here we navigate to the Networking tab and pick '' |
{{: | {{: | ||
- | **Step 3:** We switch to the Install tab and paste the following link "'' | + | **Step 3:** We switch to the Install tab and paste the following link "'' |
{{: | {{: | ||
| | ||
- | **Step 4:** We are now back at the Virtualization main page and set the Administrative status to enabled | + | **Step 4:** We are now back at the Virtualization main page and set the Administrative status to '' |
{{: | {{: | ||
Line 55: | Line 52: | ||
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. | ||
| | ||
- | **Step 1:** Navigate to SERVICES → DHCP Server and click the Edit button. Pick the specify radio button which will make some additional input windows pop up. Here you have to put the address you want the pi-hole to server to have in the Primary DNS field. Note that the address will have to be within the range of the DHCP server settings, for example 192.168.1.111, | + | **Step 1:** Navigate to SERVICES → DHCP Server and click the '' |
{{: | {{: | ||
| | ||
- | **Step 2:** Click the Edit button one more time so we can setup the pi-hole as static host. Once again we click the small plus icon and set IP address to the one you picked earlier (192.168.1.111 in my case) and MAC address to 00: | + | **Step 2:** Click the Edit button one more time so we can setup the pi-hole as static host. Once again we click the small plus icon and set IP address to the one you picked earlier ('' |
{{: | {{: | ||
| | ||
- | **Step 3:** To finalize the setup do a reboot of the router. You can do this by navigating to SYSTEM → Reboot and the hit the Reboot Now button or alternatively just run the reboot command in terminal. | + | **Step 3:** To finalize the setup do a reboot of the router. You can do this by navigating to SYSTEM → Reboot and the hit the '' |
{{: | {{: | ||
| | ||
- | **Step 4:** To verify that everything is working correctly open then pi-hole web interface by visiting http:// | + | **Step 4:** To verify that everything is working correctly open then pi-hole web interface |
{{: | {{: | ||
- | **Step 5:** To change the password we need to access the router | + | **Step 5:** To change the password we need to access the router |
- | **The installation is finished and Pi-hole is now in working condition.** You can access the webgui (192.168.1.111) any 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 '' | ||
- | ====== Advanced Installagion Guide ====== | ||
- | This is an optional alternative to Step 3 of the "Basic Install Setup Virtualization Guide" | ||
- | ===== Get latest debian image (only necessary for manual install) ===== | ||
- | |||
- | To get the latest debian armhf rootfs file please visit https:// | ||
- | |||
- | {{: | ||
- | {{: | ||
- | {{: | ||
| | ||
- | ===== Install Pi-hole manually ===== | ||
- | | ||
- | Please login on the NetModule router via SSH, Telnet or Serial connection. The virtualization should now already be running, you can check the status with the command "'' | ||
- | {{: | ||
- | | ||
- | **Step 1:** In the bash we will now attach to the linux container with the command "'' | ||
- | |||
- | {{: | ||
- | | ||
- | **Step 2:** To install curl we run the command "'' | ||
- | |||
- | {{: | ||
- | | ||
- | **Step 3:** Next we Run the command "'' | ||
- | |||
- | {{: | ||
- | | ||
- | **Step 4:** The installation will ask you a couple of questions, you can answer them all with yes or pick the default value. The installation will take approximately 15 minutes, this is the right time to get a fresh cup of coffee or tea. | ||
- | |||
- | {{: | ||
- | | ||
- | **Step 5:** When you come back you should now see the " | ||
- | |||
- | {{: | ||
- | |