---
title: AdGuardHome Sync
created: 2026-06-06
updated: 2026-06-06
type: app
tags: [catalogue, ad-block, sync, go]
confidence: high
contested: false
sources: [https://selfh.st/apps/?tag=Ad+Block, https://github.com/bakito/adguardhome-sync]
---
# 🔄 AdGuardHome Sync

> **Synchronisation de configuration entre plusieurs instances AdGuard Home**. Idéal pour les environnements multi-sites ou redondants.

## 📋 Informations Générales

| Champ | Valeur |
| :--- | :--- |
| **GitHub** | [bakito/adguardhome-sync](https://github.com/bakito/adguardhome-sync) |
| **License** | Apache-2.0 |
| **Langage** | Go |
| **Étoiles GitHub** | 2k ⭐ |
| **Dernière MAJ** | 2026-06-04 |
| **Catégorie** | [[cat-ad-block|Ad Block]] |

## 📝 Description

**AdGuardHome Sync** est un **outil complémentaire à [[app-adguard-home]]** qui synchronise :

- ✅ **Listes de blocage** (blocklists)
- ✅ **Règles de rewrite**
- ✅ **Clients et groupes**
- ✅ **Paramètres DNS**
- ✅ **Filtrage parental**

**Cas d'usage typique** : vous avez **plusieurs instances AdGuard Home** (maison, bureau, serveur VPN, parents) et vous voulez qu'elles partagent la même configuration. Sans cet outil, il faut mettre à jour chaque instance manuellement.

## 🚀 Installation

### Docker Compose

```yaml
# docker-compose.yml
version: '3.8'
services:
  adguardhome-sync:
    container_name: adguardhome-sync
    image: ghcr.io/bakito/adguardhome-sync:latest
    restart: unless-stopped
    ports:
      - "8080:8080"  # Web UI
    volumes:
      - ./config.yml:/app/config.yml
    depends_on:
      - origin
      - replicas
```

### Configuration (`config.yml`)

```yaml
origin:
  url: http://adguard-main:3000
  username: admin
  password: ***replicas:
  - name: Home
    url: http://adguard-home:3000
    username: admin
    password: ***
  - name: Office
    url: http://adguard-office:3000
    username: admin
    password: ***

# Intervalle de sync (en minutes)
runOnStart: true
interval: 5m
```

## ⚙️ Configuration Initiale

1. Configurer l'instance **origin** (celle qui détient la config canonique)
2. Ajouter les **replicas** dans le config
3. Démarrer l'outil
4. Vérifier la sync via l'UI web : `http://IP:8080`

## 🔄 Alternatives

### Open Source
- **Bash scripts + cron** — DIY, fragile
- **Ansible/Puppet** — Plus lourd mais plus complet

### Quand l'utiliser ?
- ✅ Vous avez 2+ instances AdGuard Home
- ✅ Vous voulez une config uniforme
- ❌ Une seule instance → pas besoin

## Pages Liées
- [[cat-ad-block]] — Catégorie Ad Block
- [[app-adguard-home]] — Le serveur à synchroniser
- [[haute-disponibilite]] — Contexte HA
