---
title: AdGuard Home
---

This tutorial is a follow-up to the official [Traefik tutorial](./traefik.md). It will guide you through integrating AdGuard Home with your existing `wg-easy` and Traefik setup to provide network-wide DNS ad-blocking.

## Prerequisites

- A working [wg-easy](./basic-installation.md) and [Traefik](./traefik.md) setup from the previous guides.

## Setup `AdGuardHome`

1. Create a directory for the configuration files:

    ```shell
    sudo mkdir -p /etc/docker/containers/adguard
    ```

2. Create volumes for persistent data:

    ```shell
    sudo mkdir -p /etc/docker/volumes/adguard/adguard_work
    sudo mkdir -p /etc/docker/volumes/adguard/adguard_conf
    sudo chmod -R 700 /etc/docker/volumes/adguard
    ```

3. Create the `docker-compose.yml` file.

File: `/etc/docker/containers/adguard/docker-compose.yml`

```yaml
services:
  adguard:
    image: adguard/adguardhome:v0.107.64
    container_name: adguard
    restart: unless-stopped
    volumes:
      - /etc/docker/volumes/adguard/adguard_work:/opt/adguardhome/work
      - /etc/docker/volumes/adguard/adguard_conf:/opt/adguardhome/conf
    networks:
      traefik:
        ipv4_address: 10.99.99.43
        ipv6_address: fdcc:99:99::2b
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.adguard.rule=Host(`adguard.$example.com$`)"
      - "traefik.http.routers.adguard.entrypoints=websecure"
      - "traefik.http.routers.adguard.service=adguard"
      - "traefik.http.services.adguard.loadbalancer.server.port=3000"
      - "traefik.docker.network=traefik"

networks:
  traefik:
    external: true
```

## Upgrade Network

This setup requires static IPs, so the `traefik` network must be upgraded.

1. Remove the old `traefik` network:

    ```bash
    sudo docker network rm traefik
    ```

    *(It is safe to ignore any error message if the network does not exist.)*

2. Next, create it again with:

    ```bash
    sudo docker network create --driver=bridge --subnet=10.99.99.0/24 --ipv6 --subnet=fdcc:99:99::/64 traefik
    ```

## Update `wg-easy` configuration

**Replace each section** of your existing `wg-easy` compose file with the updated version below.

File: `/etc/docker/containers/wg-easy/docker-compose.yml`

```yaml
volumes:
  etc_wireguard:
    name: etc_wireguard

services:
  wg-easy:
    ports:
      - "51820:51820/udp"
    ...
    networks:
      ...
      traefik:
        ipv4_address: 10.99.99.42
        ipv6_address: fdcc:99:99::2a
    ...
    environment:
      # Unattended Setup
      - INIT_ENABLED=true
      # Replace $username$ with your username
      - INIT_USERNAME=$username$
      # Replace $password$ with your unhashed password
      - INIT_PASSWORD=$password$
      # Replace $example.com$ with your domain
      - INIT_HOST=wg-easy.$example.com$
      - INIT_PORT=51820
      - INIT_DNS=10.99.99.43,fdcc:99:99::2b
      - INIT_IPV4_CIDR=10.8.0.0/24
      - INIT_IPV6_CIDR=fd42:42:42::/64
    ...

networks:
  ...
  traefik:
    external: true
```

## Start services

1. Start `AdGuardHome`:

    ```shell
    cd /etc/docker/containers/adguard
    sudo docker compose up -d
    ```

2. Restart `wg-easy` to apply changes:

    ```shell
    cd /etc/docker/containers/wg-easy
    sudo docker compose up -d
    ```

3. Navigate to `https://adguard.$example.com$` to begin the AdGuard Home setup.

/// warning | Important: Configure AdGuard Home Web Interface Port
During the initial AdGuard Home setup, on the page for configuring ports, you **must** set the **Web Interface port** to **3000**. Do not use the default port 80, as this will not work with the Traefik configuration.

After completing the setup, the AdGuard UI might appear unresponsive. This is expected. **Simply reload the page**, and the panel will display correctly.
///

> If you accidentally left it default (80), you will need to manually edit the `docker-compose.yml` file for AdGuard Home (`/etc/docker/containers/adguard/docker-compose.yml`) and change the line `traefik.http.services.adguard.loadbalancer.server.port=3000` to `traefik.http.services.adguard.loadbalancer.server.port=80`. After making this change, restart AdGuard Home by navigating to `/etc/docker/containers/adguard` and running `sudo docker compose up -d`.

## Final System Checks

### Firewall

Ensure the ports `80/tcp`, `443/tcp`, `443/udp`, and `51820/udp` are open.

### Optional: Optimizing UDP Buffer Sizes

AdGuard Home, as a DNS server, handles a large volume of UDP packets. To ensure optimal performance, it is recommended to increase the system's UDP buffer sizes. You can apply these settings using your system's `sysctl` configuration (e.g., by creating a file in `/etc/sysctl.d/`).

```shell
net.core.rmem_max = 7500000
net.core.wmem_max = 7500000
```

After adding these settings, remember to apply them (e.g., by running `sudo sysctl --system` or rebooting)