Table of Contents
What is Pi-hole?
Pi-hole is acting as your preferred Domain Name System (DNS) server which associates various information with domain names and filters out ads before they are reaching your device.
Instead of seeing ads about some business gurus trying to sell you their bullet-proof marketing strategies, you will just see… nothing.
Pi-hole offers several advantages, such as
- Network-wide protection
- Block in-app advertisements
- Improve network performance
- Monitor statistics
What components do I need?
All you need is
- a Raspberry Pi (I used my old Raspberry Pi 1 b+)
- Micro-USB power supply
- microSD card (32GB is sufficient)
- Network cable (optional if you use Wi-Fi)
- Keyboard for the initial phase
These are the steps we will be doing:
Step 1: Flashing the SD card
2020–02–13-raspbian-buster-lite.img // The current version as of the time of this writing
A 32GB microSD card like the one you see in the image below is sufficient for an installation of Raspbian + Pi-Hole.
Most microSD cards come with an SD card adapter, so you can plug it into one of those bigger SD card slots. I’m using the one which comes with my MacBook Pro from 2015. If it so happens that you don’t have one then you can buy a cheap USB SD card reader from Amazon. You can usually get them for around 10$.
It is up to you how you want to flash your SD card. If you are more comfortable with a graphical environment that is easy to use, then Etcher is a good choice.
Using Etcher to flash the SD card
After downloading and installing Etcher, start Etcher with the SD card plugged into your computer.
The first screen you will encounter is the following where you can select the image that you want to flash onto your SD card.
Pressing the “Select image” button on the left will open up your file browser where you can select your image. Sorry for the german locale!
As soon as you selected your image and confirmed to use it, Etcher will automatically select the SD card for you in the middle of the screen. A size of 31.9 GB is a good indicator that you don’t accidentally flash your harddrive.
If you have other SD cards plugged into your computer, it is also possible to select another one by clicking on the “Change” link in the middle.
Since I only have one SD card plugged into my Mac, Etcher only gives me one choice here.
When you are all set, press the “Flash!” button on the right. Etcher will ask for your root/administrator password before it actually flashes your card.
Etcher starts flashing your card after confirming the prompt with your password.
The last step involves a validation process to check if the image on the SD card is still in a valid state.
Congratulations! You just flashed your SD card with Etcher! You can now remove your SD card and put it into your Raspberry Pi.
Step 2: Start the Raspberry Pi and log in
When you assembled everything, it is time to start your Raspberry Pi. Plug in all the necessary cables and the power supply. After an initial boot sequence and seeing cryptic messages flowing through the screen, you should see a prompt asking for a username and password at the very end.
Type in the default username/password combination as above and you should be able to see something similar like the screenshot below.
You successfully logged-in! Now it’s time to make some configurations to your Raspberry Pi.
Step 3: Basic configuration
We will do most of our configurations using a handy tool called “raspi-config”.
By executing this command, you can change all kinds of things in a very comfortable way. You can change the locale, keyboard layout, default password, and many more. By the way, changing the default password first is a good practice but I will leave this step to you.
Changing the hostname
We will start by changing the hostname of the Raspberry Pi. By default, the hostname is set to “raspberrypi”. This is usually not a problem but because I have four different Raspberry Pi’s running on my network, I would like to be able to differentiate between them through their hostnames.
Therefore, execute “sudo raspi-config” and follow the steps below.
Set a static IP address
After successfully changing the hostname to “pihole”, we will now give it a static IP address. We need this static IP in order to set Pi-Hole as a DNS server later on. A dynamic IP would be cumbersome because then we would have to change our DNS server IP every time Pi-Hole gets a new IP by the router’s DHCP server.
To avoid any IP address conflicts, we will scan our network for IP addresses already used by other devices and then decide which IP we want to use for our Pi-Hole.
We can scan our network by using the arp command or using the nmap tool as shown below.
After we’ve chosen a suitable IP address for our Raspberry Pi (I use 192.168.2.2), we will be using nano to edit the DHCP client configuration file:
sudo nano /etc/dhcpcd.conf
Unfortunately, raspi-config is not intelligent enough to also adjust our hostname in this file. Therefore, we have to adjust the hostname at the top of the file to “pihole” manually.
Scroll to the end of the file and change the following lines according to your network setup for a static IP.
# Example static IP configuration: interface eth0 static ip_address=192.168.2.2/24 #static ip6_address=fd51:42f8:caae:d92e::ff/64 static routers=192.168.2.1 static domain_name_servers=192.168.2.1
Enable SSH server
Since I don’t want to walk all the way down to the basement every time I make a little change to the Raspberry Pi, I enable the SSH server to log in remotely. We will be using our handy “raspi-config” tool again as shown below.
After the change has been made and a reboot has been executed as a precaution, we should be able to log in remotely. Open up your terminal and type in:
ssh [email protected] // change IP address according to your setup
Done! Now you can log in remotely and comfortably from your couch using your Laptop.
Step 4: Installing Pi-Hole
After the basic configuration has been done, it is now time to actually install the Pi-hole software. The installation process is rather simple. All you have to do is to execute the following command to download the Pi-hole installation script and start the installation procedure.
curl -sSL https://install.pi-hole.net | bash
Executing this line should produce a similar result as below:
At some point during the installation, you will be confronted with some blue screens which are asking for your input. We will go through each screen step by step. Usually, you can use the default choices for each screen.
Here it says that it needs a static IP address. Luckily, we already configured that.
Here it is asking you which DNS server Pi-hole should use to resolve IPs/domains. Google is a solid choice.
Since Pi-hole relies on lists with unwanted ad domains, we have to use some repositories from third parties that maintain these lists. By default, all repositories are activated and we can leave it like that.
Since we want to block unwanted ads regardless of the IP protocol version, we can leave it to both protocols activated by default.
The IP address should be the static one you configured before for the Raspberry Pi. The Gateway is usually the IP of your router.
Yes, we want to install the web admin interface because we want to use the handy Dashboard later on.
Yes, we also want to install the web server. Otherwise we won’t be able to use the Dashboard.
Logging queries is never a bad idea and we will set it to “On”. If something goes wrong, we want to able to inspect the logs.
For the privacy mode, we also can use the default option because we want to see everything that Pi-Hole blocks inside the Dashboard.
This is the most important screen! Make a picture of it or write it down because this screen also contains the password that we need later on to log into the Dashboard.
After confirming the last screen, we are now done installing Pi-hole and the installation should be complete as shown below.
We are now ready to go over to our freshly installed Pi-hole Dashboard. You can access it inside your browser by typing “http://126.96.36.199/admin” or “http://pi.hole/admin”. Change the IP address according to your setup.
Hint: The domain “http://pi.hole/admin” only works after setting Pi-hole as your DNS server which we will do in the following step.
Step 5: Configuring DNS
There are two methods on how to use Pi-Hole as your DNS server.
First method (preferred): You can set Pi-hole’s IP address as the default DNS server inside your router. This is the preferred method because this will automatically block ads for all devices inside your network which are connected to that router.
Second method: You can set Pi-hole’s IP address as the default DNS server for your machine only. It is sometimes not possible to change the DNS server for your router, so you are left with this option.
First method: Changing the DNS server on your router
Since I do not know which router you have, I linked a tutorial on how to change the DNS server for the most popular ones.
Second method: Changing the DNS server locally
Step 6: Enter the dashboard
When everything worked, you should be able to access the Dashboard by using “http://pi.hole/admin”.
When you first access the Dashboard as a guest, it should look like the screenshot below. Not much to see. Yet.
Go over to the login page and log in with your password that you hopefully wrote down during the installation process.
After you logged in, you can see the whole variety of functions that the Dashboard has to offer.
There is one last bit we have to configure and that is more a configuration out of convenience. Go over to settings and choose the “DNS” tab.
When you scroll down to the end of the DNS configuration, you can see a section about “Conditional Forwarding”. Often routers offer a unique domain which makes them accessible a bit easier than typing their IP address into the browser. In my case, the domain “speedport.ip” translates to 192.168.2.1.
When you changed your DNS configuration, this domain is probably not accessible anymore and you have to activate “Use Conditional Forwarding” and type in the domain with the corresponding IP.
Conditional forwarding makes your router accessible again through a simple, local domain.
If you followed every step until now and you already tried out some domains on your machine to check if ads are actually getting blocked, you can go over to the Dashboard tab again. The Dashboard should show you that it already blocked domains that contained ads.
Step 7: Have fun!
Congratulations! You now have a working Pi-hole installation on your Raspberry Pi and you can enjoy the depths of the Internet without being bothered by ads.