🛡️ 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 |
tailscale-adguard-01 |
tailscale/tailscale:v1.98.4 |
4000 (mapped) |
Tailscale node for AdGuard #1 |
adguard |
11notes/adguard:0.107.77 |
53 (via Tailscale) |
Primary AdGuard Home DNS |
tailscale-adguard-sync |
tailscale/tailscale:v1.98.4 |
4001 (mapped) |
Tailscale node for AdGuard Sync |
adguard-sync |
11notes/adguard-sync:0.9.0 |
8080 (via Tailscale) |
Config sync to replica instances |
3. Networking
adguard shares tailscale-adguard-01's network namespace.adguard-sync shares tailscale-adguard-sync's network namespace.cloudflare-net — Both Tailscale containers on this for Dockflare tunnel exposure.
4. Persistent Storage
| Container |
Volume |
Description |
adguard |
adguard.etc, adguard.var (named) |
Config and data |
adguard-sync |
adguard-sync.etc (named) |
Sync config |
tailscale-adguard-01 |
tailscale (named) |
Node identity |
tailscale-adguard-sync |
tailscale.sync (named) |
Sync node identity |
5. Environment Variables
| Variable |
Service |
Description |
TAILSCALE_AUTHKEY |
Both Tailscale containers |
Auth key (from .env) |
TS_HOSTNAME |
Tailscale containers |
Adguard-01 / Adguard-Sync |
TZ |
adguard |
Australia/Sydney |
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.