Complete Installation Guide: AdGuard Home on Raspberry Pi Zero 2W

AdGuard Home is an excellent choice for network-wide ad blocking and DNS filtering on your Raspberry Pi Zero 2W. Here’s the comprehensive installation guide:adguard+1​

Prerequisites

Before beginning the installation, ensure you have the following:adguard​

• Raspberry Pi Zero 2W with Raspberry Pi OS installed
• Network connectivity (Ethernet via USB adapter or Wi-Fi)
• SSH access enabled on your Pi
• Basic terminal knowledge

Step-by-Step Installation

Step 1: Prepare Your Raspberry Pi

Connect to your Pi via SSH. First, find its IP address by running:

Enter the default password raspberry (unless you've changed it).adguard​

Step 1: Update Your System

Before installing AdGuard Home, update your system:

sudo apt update
sudo apt full-upgrade
sudo reboot

Wait for the Pi to reboot, then SSH back in.ubuntu​

Step 3: Download and Extract AdGuard Home

For Raspberry Pi Zero 2W, which uses ARM architecture, download the appropriate binary. The Zero 2W uses ARMv7 or ARMv8 architecture:adguard​

cd
wget 'https://static.adguard.com/adguardhome/release/AdGuardHome_linux_armv7.tar.gz'
tar -f AdGuardHome_linux_armv7.tar.gz -x -v

If you need the ARMv6 version instead, replace armv7 with armv6 in the download URL.adguard​

Step 4: Install AdGuard Home as a Service

Navigate to the extracted directory and install it as a system service:

cd ./AdGuardHome/
sudo ./AdGuardHome -s install

This command installs AdGuard Home as a system service that will automatically start on boot.adguard​

Step 5: Access the Web Interface

Open a web browser on any computer connected to your network and navigate to:

http://<YOUR_PI_IP>:3000

Replace <YOUR_PI_IP> with your Raspberry Pi's IP address (e.g., http://192.168.10.20:3000).adguard​

Step 6: Complete the Setup Wizard

The web interface will launch an installation wizard. Follow these steps:ubuntu​

1. Click “Get Started” to begin configuration
2. Set Network Interfaces: Configure the Admin Web Interface and DNS Server addresses and ports (default: port 3000 for admin, port 53 for DNS)
3. Create Admin Credentials: Set a username and password for administrative access
4. Review Settings: Proceed through the configuration review pages
5. Complete Setup: Click “Open Dashboard” on the congratulations page
6. Log In: Use your admin credentials to access the dashboard

Step 7: Verify Filtering Works

Test that AdGuard Home is properly blocking ads by running this command on the Pi:

host doubleclick.net 127.0.0.1

If working correctly, you should see output indicating the domain was not found:

Using domain server:
Name: 127.0.0.1
Address: 127.0.0.1#53
Aliases:

Host doubleclick.net not found: 3(NXDOMAIN)

Service Management Commands

After installation, control AdGuard Home with these commands:adguard​

sudo /opt/AdGuardHome/AdGuardHome -s start      # Start the service
sudo /opt/AdGuardHome/AdGuardHome -s stop       # Stop the service
sudo /opt/AdGuardHome/AdGuardHome -s restart    # Restart the service
sudo /opt/AdGuardHome/AdGuardHome -s status     # Check status
sudo /opt/AdGuardHome/AdGuardHome -s uninstall  # Remove the service

Configure Your Devices to Use AdGuard Home

Once AdGuard Home is running, configure your devices to use it as their DNS server. You can do this in two ways:adguard​

Router Configuration (Recommended): This automatically covers all connected devices. Access your router settings and set the DNS server to your Pi’s IP address.

Individual Device Configuration: On each device, change DNS settings to your Pi’s IP address (specific steps vary by device type).​

Your Raspberry Pi Zero 2W is now ready to protect your entire network from ads and trackers!