Use the following instructions to install Pi Hole:
https://github.com/pi-hole/pi-hole/#one-step-automated-install
Pre-Check
OK once you have set your Pi up and the WiFi is connecting to your home or office network, and you can ssh into it, continue with these easy steps! If you cannot connect via ssh yet, go back and read some of our guides until you are able to log into your Pi.
Change Hostname
I like to do this first so I don't get confused between all the different Pi's in the house.
The hostname can be set in the imager before you get started, but if you forgot or you'd like to change it afterwards, just edit the hostname with sudo nano /etc/hostname and put something else on that first line, like pi-hole
Also change it in the hosts file with sudo nano /etc/hosts to match the same name. It's probably the last line:
Reboot and when you ssh in again, use pi-hole.local
Now's also a good time to change the Pi's password with passwd
Run Pi Hole Installer
There's more information on how installation at https://pi-hole.net/ - as of the writing of this guide, its easier to just run:
curl -sSL https://install.pi-hole.net | bash
It will take quite a while to install, and may seem to 'hang' at points. Just let it do its thing for about 20 minutes!
The screenshots below are based on the 5.18.2 release of Pi-Hole. The latest version may have slightly different screens and options, but generally accepting defaults to everything should be OK.
The installer may complain about needing a requiring IP address, which is recommended. This is because DHCP reservations can expire. However, in practice, if the pi stays in communication with your DHCP server, it usually just keeps renewing the same IP address, which works well enough. if you have an advanced network set up, you can configure a custom IP address
If you have your pi has multiple network interfaces such as WiFi and an ethernet adapter, it will ask you which one you would like to use.
Pick who will be the upstream DNS (for non-ad blocked sites) - Google is fine and will probably be up all the time
The Web Interface is kinda cool, and is password protected. We'll be showing most of the stats on the little OLED but we still need the API to be running so install this.
You'll also need a web interface running, so select this as well unless you already have another one installed.
If you'd like to retain a log of the ads that are blocked, you can enable query logging. If you enable it, you'll also be asked about the amount of content that you'd like logged.
It will keep installing! Just hold tight...
When its done you'll get this final config screen! Copy & paste the password into another window for now
Test Admin Page
On your desktop computer or tablet, visit http://pi.hole/admin or if that doesn't work, try http://[your-ip]/admin (replacing [your-ip] with you IP address) and you should see an administration panel!
On your tablet, phone, computer, etc - Set up your DNS server in the network settings to be the IP address of the Pi
You may need to restart your network or browser to have it kick in, also there may be some cached ads so don't worry if not everything is blocked. Visit your favorite site with ads (not adafruit.com cuz we don't have any! :) and see the difference!
Now that you've got that done, lets continue and install the display!
Text editor powered by tinymce.
