Installing AdGuard Home on Your Network

Introduction to AdGuard Home

AdGuard Home is a powerful, open-source, network-wide ad and tracker blocking solution. Unlike browser-based ad blockers, AdGuard Home operates as a DNS sinkhole, meaning it blocks ads and trackers for every device on your network without requiring any client-side software installation. Smart TVs, gaming consoles, IoT devices, and even guest devices on your Wi-Fi all benefit automatically.

Think of it as your own personal DNS server that happens to know which domains serve ads, track users, or distribute malware. When any device on your network tries to reach one of these domains, AdGuard Home simply blocks the request before it ever leaves your network.

Hardware Requirements

One of the best things about AdGuard Home is its minimal resource requirements. It can run on almost any hardware you have lying around:

Raspberry Pi 3 or 4 - The most popular choice for home users
Old laptop or desktop - Any machine with Linux, Windows, or macOS
NAS device - Many Synology and QNAP devices support Docker
Cloud VPS - A small virtual server from any cloud provider
Docker container - Run alongside other services on existing hardware

The minimum specifications are modest: a single CPU core, 128 MB of RAM, and around 100 MB of disk space. In practice, a Raspberry Pi 3 handles a household of 20+ devices without breaking a sweat.

Installing on a Raspberry Pi

The Raspberry Pi is the ideal platform for AdGuard Home. Here is a complete walkthrough for setting it up from scratch.

Step 1: Prepare the Raspberry Pi

Start by installing Raspberry Pi OS Lite (the version without a desktop environment) on a microSD card using the Raspberry Pi Imager. Enable SSH access during the imaging process so you can configure everything remotely.

Download and install Raspberry Pi Imager from the official website
Insert your microSD card into your computer
Select Raspberry Pi OS Lite (64-bit) as the operating system
Click the gear icon to enable SSH and set a username and password
Write the image to the microSD card
Insert the card into your Pi and power it on

Step 2: Connect and Update

SSH into your Raspberry Pi and update the system packages:

ssh pi@raspberrypi.local

Once connected, run the following commands to ensure everything is up to date:

sudo apt update && sudo apt upgrade -y

Step 3: Install AdGuard Home

AdGuard provides an automated installation script that handles everything for you. Run the following command:

curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -v

The script will download the latest version of AdGuard Home, create a systemd service, and start the initial setup wizard.

Step 4: Initial Configuration

After installation, open a web browser and navigate to http://raspberrypi.local:3000. The setup wizard will guide you through the initial configuration:

Admin interface settings - Choose the listen address and port for the admin panel
DNS server settings - Set the listen address and port for the DNS server (default: port 53)
Create admin credentials - Set a strong username and password
Configure your devices - The wizard shows instructions for pointing devices to your new DNS server

Note: If port 53 is already in use (common on Ubuntu with systemd-resolved), you will need to disable the existing DNS service first. Run sudo systemctl disable systemd-resolved and sudo systemctl stop systemd-resolved before proceeding.

Installing with Docker

For users who prefer containerized applications, AdGuard Home has an official Docker image. This approach is cleaner and makes updates trivial.

Create a docker-compose.yml file with the following configuration, then run docker-compose up -d to start the container. Map port 53 for DNS, port 80 for the web interface during setup, and port 3000 for the initial configuration wizard.

Docker Advantages

Isolation - AdGuard Home runs in its own container without affecting other services
Easy updates - Pull the latest image and restart the container
Portability - Move your setup between machines easily
Backup - Simply back up the configuration volume

Configuring Your Router

Once AdGuard Home is running, you need to tell your network to use it as the DNS server. The easiest way is to configure your router's DHCP settings to distribute the AdGuard Home IP address as the DNS server for all clients.

Static IP Configuration

First, make sure your AdGuard Home device has a static IP address. If the IP changes, all DNS resolution on your network will break. Configure a static IP either on the device itself or through a DHCP reservation on your router.

Router DHCP Settings

Log into your router and find the DHCP settings. Replace the DNS server address with the IP address of your AdGuard Home device. After saving, devices will receive the new DNS server when they renew their DHCP lease. You can force this by reconnecting to Wi-Fi or rebooting the device.

Post-Installation Configuration

After the basic setup, there are several important configurations to optimize your AdGuard Home installation.

Upstream DNS Servers

AdGuard Home needs to forward non-blocked DNS queries to an upstream DNS server. By default, it uses Cloudflare and Quad9. For maximum privacy, consider using DNS-over-HTTPS or DNS-over-TLS upstream servers. Good choices include Cloudflare DoH at https://1.1.1.1/dns-query or Quad9 DoT at tls://dns.quad9.net.

Filter Lists

AdGuard Home comes with a default blocklist, but you can add more for enhanced protection. Popular additional lists include the AdGuard DNS filter, OISD blocklist, Steven Black's hosts file, and Hagezi's DNS blocklists. Add these in the Filters > DNS Blocklists section of the admin panel.

Query Logging and Statistics

AdGuard Home provides detailed statistics about DNS queries on your network. You can see which devices make the most queries, which domains are most frequently blocked, and identify unusual patterns that might indicate malware. Adjust the query log retention period based on your privacy preferences and available storage.

Maintaining Your Installation

AdGuard Home is largely maintenance-free, but there are a few things to keep an eye on:

Update regularly - Check for updates in the admin panel or enable automatic updates
Monitor query logs - Look for unusual patterns or false positives
Back up your configuration - Export the AdGuardHome.yaml file periodically
Update filter lists - Filter lists are updated automatically, but verify they are refreshing

With AdGuard Home running on your network, every device in your household benefits from ad blocking and privacy protection without any per-device configuration. It is one of the most impactful privacy improvements you can make to your home network, and the initial setup investment pays for itself many times over in improved browsing experience and reduced tracking exposure.