summaryrefslogtreecommitdiff
path: root/adguard
diff options
context:
space:
mode:
authorTyler Hoang <tyler@tylerhoang.xyz>2026-07-09 21:49:56 -0700
committerTyler Hoang <tyler@tylerhoang.xyz>2026-07-09 21:49:56 -0700
commit1d043702ef136e8f2e516c5304a57be5718f1f6f (patch)
tree9b3ad070f11dad5994c58acd41a15db8043745aa /adguard
Initial commit: docker compose files for all self-hosted servicesHEADmaster
12 services: adguard, ampache, azuracast, flood, glance, glances, grafana, immich, invidious, jellyfin, openwebui, watchtower Each service includes a docker-compose.yml, README.md with setup instructions, and .env.example where applicable.
Diffstat (limited to 'adguard')
-rw-r--r--adguard/README.md24
-rw-r--r--adguard/docker-compose.yml29
2 files changed, 53 insertions, 0 deletions
diff --git a/adguard/README.md b/adguard/README.md
new file mode 100644
index 0000000..40c7672
--- /dev/null
+++ b/adguard/README.md
@@ -0,0 +1,24 @@
+# AdGuard Home
+
+DNS ad-blocker and network-level tracker blocker.
+
+## Setup
+
+1. Create required directories:
+ ```
+ mkdir -p config data
+ ```
+
+2. Start:
+ ```
+ docker compose up -d
+ ```
+
+## Access
+
+- Web UI: `http://<host>:4000`
+
+## What to Configure
+
+- **Ports** — Port 53 (DNS) must be available. If something else on your system is already listening on port 53 (e.g. systemd-resolved), disable it or change the host ports.
+- **Subnet** — The network subnet (`172.30.0.0/24`) can be adjusted if it conflicts with your LAN.
diff --git a/adguard/docker-compose.yml b/adguard/docker-compose.yml
new file mode 100644
index 0000000..053605a
--- /dev/null
+++ b/adguard/docker-compose.yml
@@ -0,0 +1,29 @@
+services:
+ adguardhome:
+ image: adguard/adguardhome
+ container_name: adguardhome
+ restart: unless-stopped
+ volumes:
+ - ./data:/opt/adguardhome/work
+ - ./config:/opt/adguardhome/conf
+ ports:
+ - "53:53/tcp"
+ - "53:53/udp"
+ - "67:67/udp"
+ - "68:68/udp"
+ - "4000:4000/tcp"
+ - "853:853/tcp" # DNS-over-TLS
+ - "853:853/udp" # DNS-over-QUIC
+ - "5443:5443/tcp" # DNS-over-HTTPS (alt)
+ - "5443:5443/udp"
+ - "6060:6060/tcp" # pprof debug
+ networks:
+ - adguard
+
+networks:
+ adguard:
+ driver: bridge
+ ipam:
+ config:
+ - subnet: 172.30.0.0/24
+ gateway: 172.30.0.1