# Pihole Sync Receiver

Pihole Sync Receiver is the receiver-side Docker container of the Pi-hole Sync project, keeping a secondary Pi-hole in sync with a master Pi-hole on another host. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1372/pihole-sync-receiver

## Description

Pihole Sync Receiver is the receiver-side Docker container of the Pi-hole Sync project, keeping a secondary Pi-hole in sync with a master Pi-hole on another host. It automatically mirrors the master's Pi-hole and dnsmasq configuration to the local Pi-hole, so a redundant pair never drifts apart while you administer only one. It is aimed at self-hosters running two Dockerized Pi-holes as a failover pair who want a single point of configuration without granting the receiver container root access.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

30/100 (Low), based on 4 of 4 factors.
- Maintained: 0 (last commit 1352 days ago)
- Popular: 37 (70 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 95 (512 MB minimum RAM, runs on ARM)

## Links

- Docker Hub: https://hub.docker.com/r/shirom/pihole-sync
- Unraid: https://ca.unraid.net/apps/pihole-sync-receiver-1dsqvwt0cyaomh?q=Pihole-Sync-receiver

## Common questions

### Do I need to run the receiver container if the second Pi-hole is not in Docker?

No. The sender and receiver containers are only needed to solve permissions issues without giving root access. If your receiving Pi-hole is not in Docker or you are comfortable with root access, you can skip the receiver container.

### Which files and settings are synchronized between the Pi-hole instances?

It synchronizes the /etc/pihole/ and /etc/dnsmasq.d/ directories, excluding some client-independent directories. It also transfers lists and settings such as the password and upstream DNS settings.

### Does the sync happen continuously after a change?

Yes. The container monitors the selected folder for changes and immediately updates the other Pi-hole, so changes can apply right away.

### Can this sync more than two Pi-hole instances?

The project is described as synchronizing two Pi-holes, with one acting as master and one as slave. More Pi-hole support is mentioned as a future addition.

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