AdGuardHome Sync

AdGuardHome Sync is a companion service for AdGuard Home that replicates configuration from a designated origin instance to one or more replica instances. It helps keep multiple AdGuard Home deployments consistent, supporting both scheduled synchronization and one-off runs.

Key Features

• Syncs core AdGuard Home configuration areas including general settings, filters, DNS rewrites, services, clients, DNS and DHCP configuration, and UI theme
• Feature-by-feature toggles to enable or disable specific sync areas
• Scheduled execution via cron expression and optional run-on-start behavior
• Supports authentication via username/password or session cookie for environments without basic auth
• Optional auto-setup to bootstrap new replica instances during initial installation
• Optional built-in HTTP API/UI and metrics endpoint (can be disabled)

Use Cases

• Keep multiple AdGuard Home instances in sync for redundancy or multi-site networks
• Manage a primary AdGuard Home and automatically propagate filter lists and rewrites to replicas
• Standardize DNS/DHCP settings across lab, home, or small office deployments

Limitations and Considerations

• Requires AdGuard Home instances to be accessible via their web/API endpoints and initially set up via AdGuard Home’s setup flow
• Cookie-based authentication can be short-lived, making it better suited for temporary or one-time sync operations

AdGuardHome Sync is well-suited for administrators who run multiple AdGuard Home instances and want a repeatable way to keep configurations aligned. It provides granular control over what gets replicated and can be operated as a simple CLI tool, daemon, or containerized service.