Skip to content

๐Ÿ›ก๏ธ AdGuard โ€” Starbuck VPS (Instance #1 + Sync)

Host: Cloud โ€“ Starbuck VPS ยท Compose: Cloud/Starbuck/adguard/compose.yaml
Stack name: adguard

1. Overview

The primary AdGuard Home DNS instance, running on the Starbuck cloud VPS. Paired with AdGuard Sync which replicates filter lists and settings to all other AdGuard instances (Gaius, and local instances). All containers are network-isolated via Tailscale โ€” no public DNS ports are exposed.


2. Architecture & Services

Service Image Port Role
adguard 11notes/adguard:0.107.79 โ€” Primary AdGuard Home DNS
adguard-sync 11notes/adguard-sync:0.9.3 โ€” Config sync to replica instances
tailscale-adguard-01 tailscale/tailscale:v1.102.4 4000 Tailscale node for AdGuard #1
tailscale-adguard-sync tailscale/tailscale:v1.102.4 4001 Tailscale node for AdGuard Sync

3. Networking

  • cloudflare-net โ€” Both Tailscale containers on this for Dockflare tunnel exposure.
  • container:tailscale-adguard-01 โ€” Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (โ€”)))))))
  • container:tailscale-adguard-sync โ€” Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (Shares network namespace with target container (โ€”)))))))

4. Persistent Storage

| Container | Host Path / Volume | Description | |---|---|---|| | adguard | adguard.etc | โ€” | | adguard | adguard.var | โ€” | | adguard-sync | adguard-sync.etc | โ€” | | tailscale-adguard-01 | tailscale | โ€” | | tailscale-adguard-sync | tailscale.sync | โ€” |


5. Environment Variables

Variable Service Description
TZ adguard Australia/Sydney
TZ adguard-sync Australia/Sydney
TS_AUTHKEY tailscale-adguard-01 โ€”
TS_EXTRA_ARGS tailscale-adguard-01 โ€”
TS_HOSTNAME tailscale-adguard-01 Adguard-01 / Adguard-Sync
TS_STATE_DIR tailscale-adguard-01 โ€”
TS_AUTHKEY tailscale-adguard-sync โ€”
TS_EXTRA_ARGS tailscale-adguard-sync โ€”
TS_HOSTNAME tailscale-adguard-sync Adguard-01 / Adguard-Sync
TS_STATE_DIR tailscale-adguard-sync โ€”

6. Access & Usage

URL Description
https://adguard-1.m1ckyb.com Primary AdGuard web UI
https://adguardsync.m1ckyb.com AdGuard Sync web UI
docker compose -f Cloud/Starbuck/adguard/compose.yaml up -d

7. Maintenance & Backup

docker compose -f Cloud/Starbuck/adguard/compose.yaml pull
docker compose -f Cloud/Starbuck/adguard/compose.yaml up -d

Back up named volumes (adguard.etc, adguard.var) before major updates.