Skip to main content

How to install Pi-hole?

The Pi-hole is a DNS sinkhole that blocks ads, tracker and other unwanted content without having to install any client side software.

Preparation

  1. Create a Backup (instructions) (better to be prepared, since we use the scripts provided by the Pi-hole project and something could go wrong. You never now!)

Installation

  1. Run over CLI:
    sudo bash /var/scripts/not-supported.sh
  2. Choose Pi-hole
  3. Choose to install Pi-hole
  4. Select that you have created a Backup and wait a bit
  5. Click through the next popups until you have to choose the Upstream DNS provider. Choose anyone that you prefer. (It is unimportant which one you choose because you will install a local dns server later which is better than any option here.)
  6. Confirm the Blacklists
  7. Confirm the IP-Protocols (IPv4 and IPv6 are automatically selected if available; if only IPv4 is available, this popup might not be shown to you)
  8. Choose if you want to log queries
  9. Select the privacy Mode for FTL
  10. Now wait until everything is installed and it reports that Pi-hole was set up correctly and note down the admin password!
  11. Click and read through the following popups
  12. Confirm that you want Pi-hole to be a recursive DNS server (improves privacy)
  13. Wait until unbound is installed and it reports that it was successful

Pi-hole should be successfully installed by now.

What to do now?

  • First you should visit https://internal-IPv4-address:8094/admin e.g. https://192.168.178.144:8094/admin and login with your admin password.
  • You can now either configure your router to use the Pi-hole as DNS-server which will block DNS requests for all devices in your network (instructions) or you can configure your devices manually to use the Pi-hole as DNS server in your home network. (E.g. on Android by using Blokada)
    note

    If you choose to make Pi-hole the DNS server of your home network, you should most likely change the update time when updates get executed (instructions)