Home Lab DNS & Local Domains: AdGuard Home + Caddy

Introduction

In part 2 we turned our Intel N100 box into a Docker host and ran our first container, Portainer. But to reach it we typed something like https://192.168.68.110:9443 - an IP address and a port number to memorise. Add a few more services and you’re juggling a notebook full of :9000, :8096, :2283. That gets old fast.

This post fixes that, and throws in network-wide ad-blocking for free. By the end you’ll have:

• AdGuard Home filtering ads and trackers for every device on your network - phones, TVs, laptops - at the DNS level.
• A Caddy reverse proxy sitting in front of your containers.
• Clean local domains like http://portainer.home.arpa and http://dns.home.arpa instead of IP-and-port.
• Your router handing those superpowers to the whole house automatically.

It builds directly on the Docker host from part 2. Let’s get into it.

How the Pieces Fit Together

Three things cooperate here, and it’s worth seeing the whole picture before we build it:

1. AdGuard Home is a DNS server. Every device asks DNS “what’s the IP for youtube.com?” - AdGuard answers, but refuses to answer for known ad and tracker domains, so those never load. That’s the ad-blocking. Because it’s also our DNS server, we can teach it custom answers: “photos.home.arpa? That’s the home lab, 192.168.68.110.”
2. Caddy is a reverse proxy. It listens on one port (80) and, based on the hostname in the request, forwards to the right container. portainer.home.arpa goes to the Portainer container, dns.home.arpa goes to AdGuard, and so on.
3. The router tells every device to use AdGuard for DNS. Set it once, and the whole network gets ad-blocking and your custom domains - no per-device setup.

So a request for http://portainer.home.arpa flows: device → AdGuard (resolves the name to the server’s IP) → Caddy (sees the hostname, forwards to the Portainer container). Two small services, a much nicer home lab.

Step 1: Clear Port 53

A DNS server needs port 53. On Ubuntu, systemd-resolved is already listening there, so AdGuard won’t be able to start until we move it aside. This is the single most common thing that trips people up, so we do it first.

Edit /etc/systemd/resolved.conf and set the stub listener off:

1
[Resolve]
2
DNSStubListener=no

Then make sure the system still has a working resolver for itself, and restart the service:

1
sudo ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf
2
sudo systemctl restart systemd-resolved

Confirm nothing is holding port 53 anymore:

1
sudo ss -lntup 'sport = :53'

If that prints nothing, port 53 is free and we can hand it to AdGuard.

Step 2: Run AdGuard Home

Following the convention from part 2, every service gets its own folder under ~/apps. Create one for AdGuard:

1
mkdir -p ~/apps/adguardhome

Create ~/apps/adguardhome/docker-compose.yaml:

1
services:
2
  adguardhome:
3
    container_name: adguardhome
4
    image: adguard/adguardhome:v0.107.74
5
    restart: unless-stopped
6
    volumes:
7
      - ./work:/opt/adguardhome/work
8
      - ./conf:/opt/adguardhome/conf
9
    ports:
10
      - 53:53/tcp
11
      - 53:53/udp # DNS itself
12
      - 3000:3000/tcp # first-run setup wizard
13
    networks:
14
      - reverse-proxy
15

16
networks:
17
  reverse-proxy:
18
    name: reverse-proxy

A couple of things to notice. We publish port 53 (that’s the DNS service the whole network will use) and port 3000 (only needed for the one-time setup wizard). And we attach the container to a network called reverse-proxy - a shared network that Caddy will also join later, so the two can talk to each other by container name. Compose creates it automatically the first time.

Bring it up:

1
cd ~/apps/adguardhome
2
docker compose up -d

Step 3: Run Through the AdGuard Setup Wizard

Open the setup wizard in your browser:

1
http://192.168.68.110:3000

(Use your server’s IP.) The wizard walks you through a few screens:

• Admin web interface - leave it on port 80. (We don’t publish 80 to the host because Caddy will own that port; you’ll reach the dashboard through Caddy in a moment.)
• DNS server - port 53, listening on all interfaces.
• Create your admin username and password.

Once you finish, AdGuard is running and filtering. A few settings worth doing right away under Settings → DNS settings:

• Upstream DNS servers - where AdGuard forwards the queries it does answer. Cloudflare (https://1.1.1.1/dns-query) or Quad9 (https://dns.quad9.net/dns-query) over DNS-over-HTTPS are good, private defaults.
• Filters → DNS blocklists - the default AdGuard list is enabled out of the box; that alone blocks the bulk of ads and trackers.

You now have a working ad-blocking DNS server. Nothing is using it yet, though - that’s the router’s job.

Step 4: Point Your Router at AdGuard

This is the step that flips ad-blocking on for your entire network at once. The idea: your router hands out network settings to every device via DHCP, including which DNS server to use. We change that to your home lab’s IP.

In your router’s admin page, look for DHCP or LAN settings, find the DNS server field, and set it to your server’s IP:

1
Primary DNS:   192.168.68.110

Every router’s interface is a little different, so here are the official guides for the most popular brands - they’ll show you exactly where the DNS field lives on your model:

With the router updated, every device on the network now resolves through AdGuard. Check the AdGuard dashboard - you’ll see queries rolling in and a blocked-percentage climbing.

Step 5: Add the Caddy Reverse Proxy

Now for the nice URLs. Caddy will sit in front of everything, listening on port 80 and routing by hostname. Create its folder:

1
mkdir -p ~/apps/proxy

Create ~/apps/proxy/docker-compose.yaml:

1
services:
2
  caddy:
3
    image: caddy:2
4
    container_name: caddy
5
    restart: unless-stopped
6
    ports:
7
      - "80:80"
8
    volumes:
9
      - ./Caddyfile:/etc/caddy/Caddyfile
10
      - ./data:/data
11
    networks:
12
      - reverse-proxy
13

14
networks:
15
  reverse-proxy:
16
    name: reverse-proxy

Then the config itself, ~/apps/proxy/Caddyfile. This is where the routing lives:

1
# Only answer for our local home.arpa names...
2
http://*.home.arpa {
3
  @dns host dns.home.arpa
4
  handle @dns {
5
    reverse_proxy adguardhome:80
6
  }
7

8
  @portainer host portainer.home.arpa
9
  handle @portainer {
10
    reverse_proxy portainer:9000
11
  }
12
}

A word on that reverse-proxy network

You’ve seen reverse-proxy in every compose file so far, so it’s worth a proper explanation - it’s the glue that makes this whole setup tidy.

By default, containers from different Compose projects can’t talk to each other. We fix that by putting Caddy and every service it fronts onto one shared Docker network, which we named reverse-proxy. Two things fall out of that:

• Name-based addressing. Docker runs its own DNS inside that network, so containers can reach each other by container name. That’s why reverse_proxy adguardhome:80 just works - Caddy looks up adguardhome on the shared network, no IP addresses to track or hardcode.
• No published ports on the backends. Because Caddy reaches services over the internal network, those services don’t need to publish their web ports to the host at all. Only Caddy publishes port 80. Everything else stays private on the Docker network and is reachable only through the proxy - which is both cleaner and safer.

The first compose file to mention reverse-proxy creates it; every other one just joins it with the same block we’ve used in each service:

1
networks:
2
  reverse-proxy:
3
    name: reverse-proxy

From here on, every new service you add joins the same network and Caddy can route to it immediately.

1
cd ~/apps/proxy
2
touch Caddyfile   # only if you haven't created it already

Bring Caddy up:

1
cd ~/apps/proxy
2
docker compose up -d

Caddy is now listening - but if you visit http://portainer.home.arpa right now, your browser still has no idea what IP portainer.home.arpa is. That’s the last piece.

Step 6: Add Custom Domains with AdGuard DNS Rewrites

Here’s where AdGuard and Caddy connect. We need portainer.home.arpa (and any other *.home.arpa name) to resolve to the home lab’s IP, so the browser sends the request to Caddy. AdGuard does this with DNS rewrites.

Since we’re treating everything as config-as-code, we’ll add them straight to AdGuard’s config file rather than clicking through the dashboard - that way the change lands in Git with the rest of your setup. AdGuard owns and rewrites this file itself, so the safe way to hand-edit it is to stop the container first:

1
cd ~/apps/adguardhome
2
docker compose stop

Open ~/apps/adguardhome/conf/AdGuardHome.yaml, find the filtering: section, and add the two rewrites under it (a rewrites_enabled: true flag lives in the same section - make sure it’s on):

1
filtering:
2
  # ...existing settings left as-is...
3
  rewrites_enabled: true
4
  rewrites:
5
    - domain: home.arpa
6
      answer: 192.168.68.110
7
      enabled: true
8
    - domain: "*.home.arpa"
9
      answer: 192.168.68.110
10
      enabled: true

Then start it back up so AdGuard reads the new config:

1
docker compose start

The wildcard is the magic: it means every something.home.arpa name resolves to your server, so you never have to touch AdGuard again - adding a service is just a new block in the Caddyfile.

Prefer the dashboard? You can do exactly the same thing in the UI: go to Filters → DNS rewrites → Add DNS rewrite and add home.arpa and *.home.arpa, both answering with your server’s IP. AdGuard just writes those entries into the same AdGuardHome.yaml for you, so the end result is identical - the config-file route simply keeps the change in version control.

Now the full chain is live. Open:

1
http://dns.home.arpa
2
http://portainer.home.arpa

The request resolves through AdGuard to your server, Caddy reads the hostname and forwards to the right container, and you get a clean, memorable URL. Adding a new service from now on is two small steps: a handle block in the Caddyfile, and - thanks to the wildcard - nothing at all in AdGuard.

Step 7: Commit It

Same habit as part 2 - your config is code. From ~/apps:

1
git add adguardhome/docker-compose.yaml proxy/
2
git commit -m "Add AdGuard Home and Caddy reverse proxy"

Make sure your .gitignore still excludes the data directories (adguardhome/work, adguardhome/conf, proxy/data) so you commit the recipe, never the runtime data or any secrets.

What’s Next?

You’ve gone from “memorise this IP and port” to a network where ad-blocking is automatic and every service has a clean http://name.home.arpa address. The pattern scales beautifully: each new service is just another folder, another handle block, and it’s instantly reachable by name.

Coming up in the series:

1. The media stack - the *arr apps, Jellyfin, and a download client safely behind a VPN, all fronted by Caddy
2. Photos - self-hosting a Google Photos replacement with Immich (and using the N100’s iGPU for face recognition)
3. Monitoring - Grafana, Prometheus, Loki, and Alloy keeping an eye on everything
4. Going public, safely - real HTTPS certificates, exposing select services to the internet, and hardening Caddy with single sign-on (Authelia) and intrusion prevention (CrowdSec)

That last one upgrades the simple local proxy from this post into the security-hardened setup I actually run. Until then - enjoy the ad-free, IP-free home lab.