AdGuardHome Sync
Synchronize settings, filters, and client configurations across multiple AdGuard Home replicas. Run it once or on a schedule for consistent network protection.
Managing multiple AdGuard Home instances for high availability or different network segments can be tedious. This tool automates the process by synchronizing the configuration from a primary instance to one or more replicas, ensuring consistent network-wide ad-blocking and security policies.
You have granular control over what gets synchronized, with the ability to enable or disable specific features. The tool can replicate a wide range of settings, including:
- General Settings & UI Theme
- Filters, Services, and Client Settings
- DNS Configuration and Rewrites
- DHCP Configuration and Static Leases
- TLS Configuration
The tool is highly flexible, allowing configuration through a YAML file or environment variables. You can run it as a one-time sync, on a schedule using cron expressions, or as a persistent service. It can be deployed as a standalone binary, a systemd service, or easily through Docker. A key feature is its ability to automatically set up new replica instances, simplifying the expansion of your network. It also includes an optional API and web UI for monitoring sync status.
Directory Structure
docker-compose.yml
services:
adguardhome-sync:
image: ghcr.io/bakito/adguardhome-sync:latest
container_name: adguardhome-sync
environment:
- ORIGIN_URL=http://192.168.1.10:80
- ORIGIN_USERNAME=${ORIGIN_USERNAME}
- ORIGIN_PASSWORD=${ORIGIN_PASSWORD}
- REPLICA_URL=http://192.168.1.11:80
- REPLICA_USERNAME=${REPLICA_USERNAME}
- REPLICA_PASSWORD=${REPLICA_PASSWORD}
- CRON=*/10 * * * *
- RUN_ON_START=true
restart: unless-stopped.env
ORIGIN_USERNAME=admin
ORIGIN_PASSWORD=your_origin_password
REPLICA_USERNAME=admin
REPLICA_PASSWORD=your_replica_passwordTags:
Similar to AdGuardHome Sync