# AdGuardHome Sync

AdGuardHome Sync is a lightweight tool for homelab users that keeps multiple AdGuard Home instances consistent without manual reconfiguration by replicating general settings, filters, rewrites, services, clients, DNS. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/947/adguardhome-sync

## Description

AdGuardHome Sync is a lightweight tool for homelab users that keeps multiple AdGuard Home instances consistent without manual reconfiguration by replicating general settings, filters, rewrites, services, clients, DNS (Domain Name System) and DHCP (Dynamic Host Configuration Protocol) configuration, and themes from a primary instance to replicas.

## Platform availability

Available on 2 of 9 platforms: Unraid, ZimaOS.

## Health score

80/100 (Excellent), based on 4 of 4 factors.
- Maintained: 100 (last commit 14 days ago)
- Popular: 65 (1,830 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Light to run: 100 (20 MB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/linuxserver/adguardhome-sync
- Unraid: https://ca.unraid.net/apps/adguardhome-sync-10n9hln0l8mvt3?q=adguardhome-sync
- GitHub: https://github.com/bakito/adguardhome-sync

## Common questions

### Which Docker network should I use for adguardhome-sync and the AdGuardHome instances?

Put the sync container and the AdGuardHome instances on a dedicated bridge Docker network.

### Do I need to complete the AdGuardHome setup wizard on every instance before the first sync?

Yes. Both the origin instance and the replicas must be initially set up with AdGuardHome via the AdGuardHome installation wizard.

### How do I keep the sync running if one instance returns an error?

Set CONTINUE_ON_ERROR to true. This tells adguardhome-sync to continue sync on errors.

---
Source: Our Local Host (https://ourlocalhost.com/app/947/adguardhome-sync), the self-hosted and open-source app directory.
