# Nebula-Sync

Nebula-Sync is a tool that synchronizes Pi-hole v6.x configuration between a primary instance and its replicas using the Pi-hole API. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1645/nebula-sync

## Description

Nebula-Sync is a tool that synchronizes Pi-hole v6.x configuration between a primary instance and its replicas using the Pi-hole API. It supports full synchronization via Pi-hole Teleporter, selective feature copying, and automated cron-scheduled runs. Nebula-Sync is not part of the official Pi-hole project and requires Pi-hole v6 or later, which is still under active development. Available as a Docker container or Linux and macOS binaries, it is ideal for homelabbers running multiple Pi-hole instances who need consistent configuration across them.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

49/100 (Fair), based on 4 of 5 factors.
- Maintained: 72 (last commit 32 days ago)
- Popular: 64 (1,662 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 0 (7 serious findings, 4 minor, CI, tests)

## Security check

7 serious findings: Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.48.0, which has a known critical vulnerability.
Automated checks on commit c31e0c7, 24 Oct 2026. Not an audit.

## Links

- Docker Hub: https://hub.docker.com/r/lovelaze/nebula-sync
- GitHub: https://github.com/lovelaze/nebula-sync
- Unraid: https://ca.unraid.net/apps/nebula-sync-0gn9eyp1fiq539?q=nebula-sync

## Common questions

### Is nebula-sync an official Pi-hole project?

No. It is not part of the official Pi-hole project, but it uses the API provided by Pi-hole instances to perform synchronization actions.

### What should I change if nebula-sync causes nightly database outages?

A reported cause was the gravity sync/update. Setting RUN_GRAVITY to false stopped the outages.

### Can I self-host it with Docker?

Yes. The self-host directory page provides a Docker install guide for nebula-sync.

### Where can I ask setup or code questions for the project?

The project has GitHub Discussions for discussing code, asking questions, and collaborating with the developer community.

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