Differences

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

--- pi-hole:setup_pi-hole_running_in_ubuntu [2020/11/16 16:11] – created peter
+++ pi-hole:setup_pi-hole_running_in_ubuntu [2020/11/16 16:26] (current) – peter
@@ Line 1: / Line 1: @@
 ====== Pi-Hole - Setup Pi-Hole running in Ubuntu ======
+It is recommended to have a dedicated Ubuntu instance for pi-hole.
+This could be an actual physical machine, or a VM.
+<WRAP info>
+**NOTE:**  The pi-hole is very lean and uses a minimal amount of system resources.
+So you do not need to allocate a huge amount of memory to this Ubuntu instance; 8G should be sufficient.
+G of Hard disk space is also more than enough.
+</WRAP>
+----
+===== Update and Configure Ubuntu =====
+On the Ubuntu instance where you want to run pi-hole, run updates:
+<code bash>
+sudo apt update
+</code>
+Next install the ssh server:
+<code bash>
+sudo apt install -y openssh-server
+</code>
+Now add a username other than the default. Just go through the dialogue and answer the prompts for the new user:
+<code bash>
+sudo adduser piuser
+</code>
+Now grant the new user privilege:
+<code bash>
+sudo usermod -aG sudo piuser
+</code>
+Ensure that you know the IP Address of this Ubuntu instance:
+<code bash>
+ip addr
+</code>
+<WRAP info>
+**NOTE**:  For this example, we assume the IP Address is 192.168.1.25
+</WRAP>
+----
+===== SSH into the Ubuntu =====
+Open a terminal back on your desktop computer and "ssh" to the Ubuntu machine with the IP Address:
+<code bash>
+ssh piuser@192.168.1.25
+</code>
+Get root privileges in the command window:
+<code bash>
+sudo -i
+</code>
+Install "curl":
+<code bash>
+sudo apt install curl
+</code>
+Now you can install pi-hole:
+<code bash>
+curl -sSL https://install.pi-hole.net | bash
+</code>
+Select the defaults until the DNS screen and then choose Cloudflare as your DNS.
+  * Accept all the rest of the defaults and be careful not to change them.  This will assure that you get the admin web interface and that statistics are logged.
+  * The installation will continue for a few minutes after you answer the prompts.
+  * After your installation completes, you will receive a message telling you to set up the DHCP settings on your router to make the address of your Pi-Hole the primary DNS for your network.
+    * That will insert the Pi-Hole as the "man-in-the-middle" to scrutinize all DNS names before they are either passed to the Internet or "Pi-Holed".
+When you return to the prompt in the "ssh" terminal session, enter the following command to set your Pi-hole password:
+<code bash>
+pihole -a -p
+</code>
+You can now close the "ssh" terminal session.
+<code bash>
+exit
+</code>
+----
+===== Go to your Pi-Hole Website =====
+Go to your web browser and enter the address of your Pi-Hole followed by /admin:
+<code bash>
+http://192.168.1.25/admin
+</code>
+Select the **login** option and you should be able to log in with the password you just set.
+<WRAP info>
+**NOTE:**  Since this is running in a standard Ubuntu instance, you will be able to reboot without any problems and even upgrade Pi-Hole when new releases are available.
+The pi-hole is also very lean and uses a minimal amount of system resources.
+</WRAP>
+<WRAP important>
+**IMPORTANT:**  Don't forget to set the DNS settings for your DHCP server on your router because Pi-Hole will not be used by any of your network clients until that occurs.
+A good practice is to make the Pi-Hole DNS 1 and then Cloudflare 1.1.1.1 as DNS 2.
+That will assure DNS translation when your Pi-Hole is not running.
+</WRAP>
+----
+===== References =====