Select Page
Setup and Configure a Network Wide Adblocker

Setup and Configure a Network Wide Adblocker

Setup and Configure a Network Wide Adblocker


  • Completely Free.
  • Network-wide ad block on all devices.
  • Simple install – Just one line of code!

Pi-hole is one of the greatest Raspberry Pi projects ever, a network wide ad-blocker that’s easy to install and ensures all devices on you network benefit from it’s fantastic advert blocking magic.

It’s highly recommended to use a Raspberry Pi 3 B+ that is connected to the network via an Ethernet cable. Earlier models of Raspberry Pi will work as well, but for the best performance on a busy network use a Pi 3 B+.

Technical Jargon

IP Address (IP)

An IP address is a unique (numeral) address that is used to identify a device on the network. Every computer has an IP address and these are used by computers to talk to one another.

Think of it like your postal address or telephone number. If someone wants to contact you they use your unique address, this is the same for a computer and its IP.

Click here for a full detailed description of IP address.


A computer hostname is similar to you wearing a name badge. Computers can be known by their unique IP address, or a nick name (hostname) can be assigned to them. The hostname is the easy to remember name of a computer and like the IP address must be unique on the network.

Click here for a full detailed description of computer hostnames.


DHCP stands for Dynamic Host Configuration Protocol and a DHCP server is the server tasked with giving computers without an IP address their address. It is similar to going to the theater and the box office assigning you a seat. They make a note of your seat row and number so if you’re needed during the performance someone can find you. This is the same job the DHCP server has, it gives computer A an IP address and then gives that address to the DNS server so when other computers want to find computer A they are told where they can find them.

A server usually has a range of IP addresses it is allowed to hand out. E.g. To If you are using a static IP address you’ll want to pick one outside of the range.

Click here for a full detailed description of DHCP.


DNS  stands for Domain Name System. A DNS server is like an old fashioned address book. It holds all of the hostnames and IP addresses of computers on the network so when we want to talk to Computer A we can ask the DNS server for their address and they will find it for us. Once found we can then go and contact Computer A.

Click here for a full detailed description of DNS.


SSH stands for secure shell. SSH is an encrypted connection established between two computer programs. On the server side (the computer being connected to) a service is running that listens for another computer trying to contact it via SSH.

Click here for a full detailed description of SSH.



This guide assumes you have a fresh install of Raspbian on a headless server.

This guide assumes you have set a static IP address.

How to Install Pi-hole

Before we start we’re going to ensure the Raspberry Pi is up to date. Run the following commands to grab and install the latest packages:

sudo apt-get update
sudo apt-get upgrade -y

Once everything is up to date it’s time to install Pi-hole using the following command. Note, this must be run by a user with sudo privileges (the user pi has sudo privileges):

curl -sSL | bash

If you receive the error “curl: (60) SSL certificate problem: certificate is not yet valid”, don’t worry, you’ll just need to use the following command that ignores the reported error. We’ve added “k” to the list of options used during the installation. -k (or –insecure) allows curl to perform insecure SSL connections and transfers:

curl -sSLk | bash

Once the installation starts you’ll be prompted with a number of windows. Most can be dismissed straight away with hitting return, but some will require input. The following images will run you through what to input.

A plea to support Pi-hole. If you want to donate anything, follow the URL. From here just hit enter to continue.

A network warning that we can ignore because we’ve already setup a static IP address. Hit return to continue.

This section allows you to select the Upstream DNS Provider. Pi-hole lists a number of popular DNS provides or you can input customs ones by scrolling down. Let’s scroll down and pick CloudFlare for this guide.

This page allows us to pick all the block lists that Pi-hole will use. It’s recommended to leave it as default and use all of the selected ones. We can white list any sites we want to allow through. E.g. Google Ads.

This page is asking which protocols we want to use Pi-hole on. It’s best to leave it as default and block ads on both PIv4 and IPv6.

This is just a confirmation before we continue of the IP address and gateway that will be used for Pi-hole configuration. Hit enter to continue.

This is just a warning about IP addresses. We’ve sorted this already so can ignore it. Hit enter to continue.

We’re going to be using the web admin interface to configure Pi-hole and check statistics. Make sure “On” is selected and hit return.

This is a completely fresh install so we don’t have an existing web server. Make sure “On” is selected and hit return to allow the Pi-hole installation to do the hard work for us on installing and configuring the web server.

To generated the statistics for the admin page we need to keep logs. Make sure On is selected and hit return.

FTL is what displays the graphs and statistics. We want to monitor everything we can so we’re going to select “Show everything” and hit return. After this the console will flash on and off as it installs, it could take a while depending on the speed of your microSD card, Raspberry Pi and internet. I made a lovely cuppa while it installed.

Congratulations! You’ve got a successful install of Pi-hole on your Raspberry Pi. Now you’re all ready to update your router and enable network wide adblocking. Make sure to take a note of the admin webpage login password.

Pi-hole Admin

Now you’ve successfully installed Pi-hole go to the url provided at the end of the installation. For mine it is and you should be greeted by an admin page showing high level information. At the moment mine is empty because we we’re not passing dns requests through it.

On the left hand side click Login and then enter the password from earlier. You’ll then be returned to an updated index page with more graphs and a lot more menus on the left hand side. If you have forgotten the password you can run the following command from the console to reset it and pick your own:

pihole -a -p

Once run you’ll be prompted for a new password and can imediately use the password to login to the admin web page.

I won’t be exploring any of the menus here, they are set to excellent defaults and most easily understandable.

The most likely menu you’ll use is Whitelist. The Whitelist is a list of websites that you want to allow adverts from. Maybe it’s your favourite content provide and you want to support them, or maybe you find certain adverts useful in your browsing. Just pop their URL in the Whitelist box, click add and you’ll be greeted with your whitelisted content.

Pi-hole Maintenance

There really isn’t much to do here, Pi-hole is pretty self regulating. Unfortunately it isn’t currently possible to update Pi-hole from the web interface. Keeping it simple and having it updated only when you decide to, if you login and see a new version is available the update process is a simple one.

SSH into the Raspberry Pi running Pi-hole and run the following:

pihole -up

This command will check for updates and if one is available update Pi-hole and reboot. If you’re feeling really clever you could set a CronTask to run periodically to automatically update Pi-hole.

Router Setup – Wiring it all up

The final step in the process is to direct all of your DNS requests through Pi-hole so it will start filtering what comes back and providing an advert free experience to all devices on your network.

I use pfSense as my router, so the following screenshots are probably of little to no use to you. However, the process is the same no matter what router you use so long as you have the ability to update your DNS servers.

First off, log into your router’s admin section and find the settings for DNS servers. If you’re using pfSense it’s System then General Setup.

Make a note of (in case everything goes wrong) the current DNS servers before deleting the entries.

Add a single DNS server with the IP address of the Raspberry Pi that is running Pi-hole and click save.

Now the DNS settings have been updated all of your devices should be using Pi-hole for their DNS resolution and you shouldn’t see any adverts (or at least very few) on any device that is connected to your network.

If you are having problems connecting to the internet after the change try restarting your device first to see if that fixes the problem. If everything fails, hop back into your router’s admin interface and put the original DNS server IPs back.

If you’re able to access the internet, jump back into Pi-hole’s web admin interface and see all the traffic that’s getting blocked!


Congratulations! You’ve got a working adblocker for every device on your network. It’s time to sit back and enjoy the internet in all it’s advert free glory!

If you want to test your adblocker is working, try a few of the sites below. – A list of sites recommended by pi-hole themselves for testing everything is working. – A simple site for testing if adblock is working. Don’t see an advert? It’s working! – It’s an older site but gives a straight to the point popup telling you if your adblocker is working.