imthai/adguardhome-unbound-redis repository overview

⁠🚀 AdGuard Home + Unbound + Redis

A Docker container combining AdGuard Home⁠, Unbound⁠ (with DNS prefetching), and Redis⁠ as an in-memory caching layer — built for speed, privacy, and performance.

This image is multi-architecture and provides native support for both amd64 (PCs, Unraid servers) and arm64 (Raspberry Pi, Apple M-series, etc.) platforms.

⁠🔍 Why This Setup?

⁠✅ Benefits of Unbound with Prefetching:

• Faster DNS Resolution: Frequently accessed DNS records are proactively resolved and cached.
• Lower Latency: Reduces delays caused by DNS lookups, especially useful for latency-sensitive applications.
• Better Network Performance: Prefetched responses are immediately available, reducing wait times.

⁠🧠 Benefits of Using Redis:

• In-Memory Speed: Redis caches DNS results in memory, offering near-instant retrieval.
• Improved Throughput: Offloads repetitive DNS requests from upstream servers.
• Reduced Load: Minimizes the number of external DNS queries.
• Reliable Caching: Maintains fast access even under heavy load.

⁠🚀 Quick Start (docker-compose)

Here is a sample docker-compose.yml to get you started.

version: "3.8"
services:
  adguard-dns:
    image: imthai/adguardhome-unbound-redis:latest
    container_name: adguard-dns
    # It's recommended to use a dedicated IP (macvlan/ipvlan)
    # or, if in bridge mode, map the necessary ports:
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "3000:3000/tcp" # AdGuard Web UI port
    volumes:
      # /config is the main volume for all config and data
      - ./config:/config
    restart: unless-stopped

⁠⚙️ Configuration and Paths

⁠🔷 Note for Unraid Users

This container is tailored to work well with Unraid.

1. When adding the container, map the Container Path /config to your desired Host Path in appdata, e.g., /mnt/user/appdata/adguard-unbound-redis/
2. It is highly recommended to assign a dedicated IP (e.g., br0.100) to the container, as port 53 is often occupied by Unraid/Docker.

⁠📂 File Structure

All configuration is persisted in the volume you map to /config. After the first run, this folder will be populated with:

Default Settings:

• AdGuard Home Web UI: http://<your-ip>:3000
• Default credentials: admin / admin

⁠🌐 DNS Configuration

By default, Unbound is set to forward all DNS requests to public resolvers. Currently, Cloudflare DNS is used.

• You can modify this behavior in the ./unbound/forward-queries.conf file.
• Other DNS providers are pre-defined and can be customized or added.
• To enable full recursive resolution (where Unbound queries root servers directly), simply delete the forward-queries.conf file and restart.

⁠📂 Custom User Filters

You can now add your own filter blocklist files to the container by placing them in the ./userfilters/ folder.

Important: To enable AdGuard Home to read your custom filter files, you must ensure that your configuration file (./AdGuardHome/AdGuardHome.yaml) contains:

safe_fs_patterns:
  - /config/userfilters/*

⁠📂 Custom User Filters

You can now add your own filter blocklist files to the container by placing them in the /config/userfilters/ folder.

Important:
To enable AdGuard Home to read your custom filter files, you must ensure that your configuration file (AdGuardHome.yaml) contains:

safe_fs_patterns:
   - /config/userfilters/*

You have two options:

• Option 1: Manual update Edit AdGuardHome.yaml and add or update the safe_fs_patterns section as shown above. Then restart the container.

• Option 2: Auto-generate fresh config Delete (or move) your existing AdGuardHome.yaml config file and restart the container. The container will create a new config file with the correct safe_fs_patterns entry by default. ⚠️ Warning: This resets all your AdGuard Home settings!

Afterwards: Add your local blocklist(s) in AdGuard Home’s web UI (Filters → DNS blocklists) by specifying the file path, for example: /config/userfilters/myblocklist.txt.

⁠🚫 Blocklists Enabled by Default

• AdGuard DNS Filter⁠
• HaGeZi's Threat Intelligence Feeds⁠
• HaGeZi's Multi PRO Blocklist⁠

Enjoy faster, smarter, and more private DNS with this all-in-one Docker solution! 🛡️⚡