How to Set Up AdGuard Home on Raspberry Pi

AdGuard Home is a powerful, modern network-wide ad blocker that runs as a DNS server. Unlike Pi-hole, it comes with a clean UI and built-in parental controls. Here's how to install it on your Raspberry Pi.


Requirements

  • Raspberry Pi (Zero 2 W, 3, 4, or 5)
  • Raspberry Pi OS (Lite or Full)
  • Internet connection
  • SSH or Terminal access

Step-by-Step Installation

1. Update your system

sudo apt update && sudo apt upgrade

2. Download the AdGuard Home installer

wget https://static.adguard.com/adguardhome/release/AdGuardHome_linux_armv7.tar.gz

3. Extract the archive

tar -xvf AdGuardHome_linux_armv7.tar.gz

4. Navigate into the extracted folder

cd AdGuardHome

5. Start the installation

sudo ./AdGuardHome -s install

This will install and start AdGuard Home as a system service.


Access the Web Interface

Once installed, visit this in your browser:

http://your_pi_ip:3000

Follow the setup wizard:

  • Set an admin username and password
  • Select default settings or customize as needed
  • Set the upstream DNS (like Cloudflare or Quad9)

Set as DNS on Your Network

To block ads on all devices:

  1. Log into your router
  2. Find the DNS or LAN settings
  3. Set the DNS server to your Raspberry Pi’s IP address

Devices connected to your network will now automatically use AdGuard Home!


Useful Commands

  • Restart service: sudo systemctl restart AdGuardHome
  • Stop service: sudo systemctl stop AdGuardHome
  • View logs: sudo journalctl -u AdGuardHome

Features of AdGuard Home

  • Blocks ads, trackers, malware domains
  • Custom DNS rules and filters
  • Parental controls and safe search
  • Beautiful real-time dashboard

Final Thoughts

AdGuard Home is a fast, easy way to secure your entire network. Whether you're blocking ads or enforcing family-safe browsing, your Raspberry Pi makes it free and local. Enjoy ad-free browsing everywhere!

Comments