Learn How to Run AdGuard Home using Docker

In this tutorial, we will show you how to run AdGuard Home on your device using Docker.

AdGuard Home is a network-wide adblocking DNS service that works like the hugely popular Pi-Hole.

Like Pi-Hole, AdGuard acts as your DNS server. It filters out any DNS requests that are for known tracking or domain names. The main difference between these two services is that AdGuard is a little bit more polished but not nearly as configurable, so it is a great alternative for those who want something easy to use out of the box.

The advantage of using a network-wide ad-blocker like AdGuard Home is that you only need to point your devices to your server. There is no need to install specific software on any of your devices to start blocking ads. Additionally, it is great for devices like smart TVs where you can’t install an adblocker.

There are various ways to run AdGuard Home, one of the easiest being to use Docker. Docker is a great solution because it can be up and running in minutes. It also makes it very clean to uninstall if you ever stop using the adblocker.

Remember that if you use an adblocker, you should consider supporting websites that you view often. Ads help pay for content creation and help websites stay online. If you want to support us, we offer a premium ad-free experience.

The official AdGuard Home Docker image that we are using supports almost all major system architectures, so these steps should work on almost all devices, including the Raspberry Pi.

Please note that your device should be set up with a static IP address before proceeding. Using a DHCP reservation through your router is the best way to achieve this.

Installing AdGuard Home using Docker

The following sections will show you how to run AdGuard Home on your machine using Docker.

Using Docker Compose is one of the easiest and fastest ways to get this network-wide adblocker up and running on your device.

Installing Docker to your Machine

1. Of course, to run the AdGuard Home Docker container, you must have the Docker runtime installed on your system. If you already have this runtime installed, you can safely skip to step 4.

Otherwise, you can install Docker using this easy-to-use one-liner. This command will use curl to download and run an install script directly from Docker.

curl -sSL https://get.docker.com | sh

2. After installing the Docker runtime, you must add your current user to the “docker” group. You can add yourself to this group by using the usermod command.

Adding your user to this group will give you control over containers without needing to be the root user.

sudo usermod -aG docker $USER

3. After making adjustments to your user, you must log out and in again. This is because programs, including the running terminal session, won’t know your user’s new group.

Luckily, you can log out by using the following command.

logout

If, for some reason, you still have issues after logging out, you can always restart your machine with the command below.

sudo reboot

Preparing for AdGuard Home’s Docker Container

4. With Docker installed, we can start setting up your system to run the AdGuard Home container.

Let us start this installation process by creating a directory to store a Docker Compose file for AdGuard Home. Not only will this directory store the Compose file, but it will also be where AdGuard stores its persistent data.

sudo mkdir -p /opt/stacks/adguard

5. We can use the cd command to change into the directory we just created. The rest of this guide will be spent within this directory.

cd /opt/stacks/adguard

Writing a Docker Compose File for AdGuard Home

6. We can now move on to the core part of getting AdGuard Home to run using Docker. This next step involves us writing a Compose file. This Compose file is like a set of instructions that the Docker runtime will use to download and run the AdGuard Home container.

Using the following command, we can use the nano text editor to start writing this Compose file.

sudo nano compose.yaml

7. Within this file, you will want to type in the following lines.

One thing you will notice with AdGuard is that it requires a lot of open ports. Luckily, Docker will typically handle letting these through your system’s firewall.

services:
  adguardhome:
    image: 'adguard/adguardhome:latest'
    container_name: 'adguard'
    hostname: 'adguard'
    restart: 'unless-stopped'
    volumes:
      - '/etc/localtime:/etc/localtime:ro'
      - './work:/opt/adguardhome/work'
      - './config:/opt/adguardhome/conf'
    ports:
      # Plain DNS
      - '53:53/tcp'
      - '53:53/udp'
      # AdGuard Home Admin Panel as well as DNS-over-HTTPS
      - '80:80/tcp'
      - '443:443/tcp'
      - '443:443/udp'
      - '3000:3000/tcp'
      # DNS-over-TLS
      - '853:853/tcp'
      # DNS-over-QUIC
      - '784:784/udp'
      - '853:853/udp'
      - '8853:8853/udp'
      # DNSCrypt
      - '5443:5443/tcp'
      - '5443:5443/udp'

8. Once you have finished filling out the Compose file, save and quit by pressing CTRL + X, Y, and then ENTER.

Starting the AdGuard Home Container

9. With everything now set up, we can start the AdGuard Home Docker container using the following command.

Docker will download the AdGuard Home image and then spin it up using the details we provided within the Compose file.

docker compose up -d

Accessing the Web Interface

10. With the AdGuard Home container running, you can now access its web interface.

Of course, to access the web interface you will need to know the IP address of your machine. You can use the hostname command to easily get the IP addresses that have been assigned to your machine.

hostname -I

11. Now, within your favourite web browser go to the following address.

Ensure that you replace “” with the IP of the device you are using to host AdGuard Home.

http://:3000

First Time Setup of the AdGuard Home Web Interface

12. When you first access the AdGuard Home web interface you will need to complete the initial setup experience.

To get started with this process, click the “Get Started” button.

13. This next screen will allow you to adjust the ports and interfaces on which the network ad blocker will listen.

Since this runs within a container, none of these settings should be changed. If you want to use a different port, adjust it using the Docker Compose file, not this interface.

To continue with the setup process, click the “Next” button.

Set Ports for AdGuard Home to use in Docker

14. You can now create an account to manage your AdGuard Home Docker setup from its web interface.

Use this screen to specify a username and password for your admin account (1.).

Once done, click the “Next” button (2.) to create your admin account.

15. The final screen gives steps to configure your devices to use AdGuard Home as your DNS server.

However, one thing we must warn you about is that you must ignore the IP addresses shown on this screen (1.). These IP addresses are the internal ones the Docker container sees, not the external ones belonging to your device.

Once you have configured your devices, click the “Next” button (2.) to complete the setup of AdGuard Home.

16. You will now see a big message congratulating you for setting up AdGuard.

To go to the dashboard, click the “Open Dashboard” button.

17. Before you can access the dashboard, you will want to enter the username and password for your new admin (1.).

After filling out your details, you can click the “Sign in” button (2.) to access the dashboard.

18. Below, you can see that we have successfully set up AdGuard Home using Docker and now have access to its web interface.

You can use this interface to view how your network-wide ad blocker is performing. You can also use it to configure filters and control various settings.