Setting up a Pi Hole for whole-home ad/tracker blocking

Pi Hole - Admin DNS query request dashboard page in Safari

Pi Hole is a nifty open source project that allows you to offload the task of blocking advertisements and annoying (and often malicious) trackers to a Raspberry Pi. The installation is deceptively simple (a curl | bash affair), but I wanted to document how I set up mine headless (just plugging the Pi into power and the network).

Set up Raspbian Lite

I bought a Raspberry Pi model 2 B along with the official Raspberry Pi foundation Case. Then I bought a Samsung Evo+ 32GB microSD card (which comes with a full-size SD card adapter), and did the following steps on my MacBook Pro to set up the Pi's OS:

  1. Download Raspbian Jessie Lite. Expand the downloaded Zip file.
  2. Insert the microSD card (in the SD adapter) into your SD card reader.
  3. Open Terminal, and run diskutil list
  4. See which disk the microSD card is (e.g. /dev/disk2), then unmount the card: diskutil unmountDisk /dev/disk2).
  5. Change directories into the directory where you downloaded Raspbian Jessie Lite (e.g. cd ~/Downloads).
  6. Run the following command to write the disk image to the microSD card: sudo dd if=2017-03-02-raspbian-jessie-lite.img of=/dev/rdisk2 bs=1m
    • Use the filename for the image version you downloaded; it might be different than the if shown above.
    • Note that the of (output) is using /dev/rdisk2—don't use /dev/disk2 because that will result in a much slower copy operation.
    • If you have pipeviewer installed, you can use pv yyyy-mm-dd-raspbian-jessie.img | sudo dd of=/dev/rdisk2 bs=1m instead to show copy progress.
  7. After the copy is finished, you should see a new boot SD card mounted on your computer.
  8. Create an 'ssh' file to tell Raspbian to enable SSH on boot (so you can log into the Pi remotely): in Terminal, run touch /Volumes/boot/ssh
  9. Eject the boot volume, and put the microSD card into your Raspberry Pi.

Note: Don't use WiFi for Pi Hole, because that would introduce a lot of latency for DNS calls. It's better to plug your Pi (no matter what flavor) into the wired network so it doesn't become a bottleneck for your Internet connection!

Set up the Raspberry Pi

  1. Plug your Pi into the network, and plug in power so the Pi will boot.
  2. Use nmap (e.g. sudo nmap -sP or fing (e.g. sudo fing to discover your Raspberry Pi's IP address (see how in my post on setting up a Pi as a remote time-lapse camera).
  3. Log into the Pi via SSH: ssh pi@ip_address (where ip_address is the IP of the Pi) — accept the hostkey by typing yes when prompted, then enter the default Pi password, raspberry.
  4. Set a static IP address: sudo nano /etc/dhcpcd.conf to edit the configuration, then add the following to the end (using the settings specific to your network/IP):

    interface eth0
    static ip_address=
    static routers=
    static domain_name_servers=
  5. Reboot the Pi (sudo reboot) and log back in via SSH.

  6. Run sudo raspi-config to configure basic settings:
    • Set a new (secure) password.
    • Set a hostname (e.g. pi-hole).
  7. Restart the Pi after changing those settings.

It's a good idea to set a static IP address for your Pi—either in the Pi's own settings, or (preferably) on your network's router (if the router allows you to assign static IP addresses to devices based on MAC address).

Set up Pi Hole

  1. Install Pi Hole with curl -sSL | bash
  2. Follow the entire Pi Hole setup process (it will ask you to confirm settings at a few different points).
  3. Note the admin dashboard password at the end of the install process; you can visit the dashboard afterwards and see DNS statistics.

Tell your router to use Pi Hole (for network-wide protection)

If you have a decent network router (in my case, I have an AirPort Extreme), you can use its administration interface to set up DNS settings for the entire network. Point the DNS at the Pi Hole's IP address, and then you should start seeing that all the network's DNS requests are routed through the Raspberry Pi's DNS. You should also note a lack of advertisements in your browsing :)

Alternatively, you can configure any of your computers to use the Pi Hole's DNS (instead of the router) if you don't want the Pi Hole to be used on the entire network.


Hi Jeff, I am getting 'could not resolve host' error on the set up stage.

Think it may be something to do with the static IP settings: interface eth0
static ip_address=

static routers=
static domain_name_servers=

I presume the top one stays as.24, but what about the other two, are they the pi's IP address?


The instructions in this post presuppose your local network is using the private IP range If your local network uses a different range, you need to adjust all those settings. (E.g. if your computer is getting the address 192.168.x.x, then you'd need to use your network router address for the routers, your default DNS server (usually same as your router) for domain_name_servers, and an IP in that range for ip_address.