How to install and run AdGuard Home on a Raspberry Pi
You can install AdGuard Home on your Raspberry Pi and use it to filter ads and save traffic. Once it is installed, you can use your AdGuard Home on any machine connected to the same local network.
Prepare your Pi
You'll need a Raspberry Pi with network access and SSH enabled. Connect it to a display and a keyboard, boot it, and write down the IP address that has been assigned to your Pi:
hostname -I | xargs -n 1
If there are several IP addresses, write down the first one. Switch back to your main computer, but keep your Pi running, and launch an ssh client. On Windows, you can use PuTTY, while on Linux, macOS, and other Unix-like OSes, you can just use your preferred terminal emulator.
Type:
ssh pi@192.168.10.20
(where 192.168.10.20 is the IP you've written down) and then type your Pi's
password (which is raspberry unless you've changed it already). Once you're
done, you will be greeted by the command line interface. Now you're ready to
install your own AdGuard Home!
Install AdGuard Home
Go to AdGuard Home page and download binaries for Raspberry Pi:
cd
wget 'https://static.adguard.com/adguardhome/release/AdGuardHome_linux_armv6.tar.gz'
tar -f AdGuardHome_linux_armv6.tar.gz -x -v
(Replace armv6 with the ARM version that is best supported by your Pi.)
That command unpacks the necessary data into a new directory called
AdGuardHome. Run this command to install AdGuard Home as a service:
cd ./AdGuardHome/
sudo ./AdGuardHome -s install
Here are the other commands you might need to control the service:
-
AdGuardHome -s uninstall: uninstall the AdGuard Home service. -
AdGuardHome -s start: start the service. -
AdGuardHome -s stop: stop the service. -
AdGuardHome -s restart: restart the service. -
AdGuardHome -s status: show the current service status.
Check the filtering
You can verify that it's working properly by running this on your Pi:
host doubleclick.net 127.0.0.1
If everything works correctly, you will get this output:
Using domain server:
Name: 127.0.0.1
Address: 127.0.0.1#53
Aliases:
Host doubleclick.net not found: 3(NXDOMAIN)
Configure your devices
Once it is confirmed that AdGuard Home works on our Raspberry Pi, you can use it on other computers in your network by changing their system DNS settings to use the Pi's IP address.
Go to the “Setup Guide” page in the web interface and follow the instructions.