/gravity-sync

💫 The easy way to synchronize the DNS configuration of two Pi-hole 5.x instances.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

Gravity Sync

Gravity Sync

Find out what's new in version 4.0!

What is better than a Pi-hole blocking trackers, advertisements, and other malicious domains on your network? That's right, two Pi-hole blocking all that junk on your network!

But if you have redundant Pi-hole in your network you'll want a simple way to keep the list configurations and local DNS settings identical between the two. That's where Gravity Sync comes in. Setup should only take a few minutes.

Features

Gravity Sync replicates the core of Pi-hole's ad/telemetry blocking settings, which includes:

  • Adlist settings with status and comments.
  • Domain/RegEx whitelists and blacklist along with status and comments.
  • Clients and group assignments, along with status and descriptions.

Gravity Sync also replicates local network DNS/DHCP settings, which includes:

  • Local DNS Records.
  • Local CNAME Records.
  • Static DHCP Assignments.

Limitations

Gravity Sync will not:

  • Modify or sync the individual Pi-hole's upstream DNS resolvers.
  • Merge query logs, statistics, long-term data, caches, or other resolution information.
  • Sync individual Pi-hole DHCP scoping information or leases.

Setup Steps

  1. Review System Requirements
  2. Install Gravity Sync
  3. Configure Gravity Sync
  4. Execute Gravity Sync
  5. Automate Gravity Sync

Disclaimer

Gravity Sync is not developed by or affiliated with the Pi-hole project. This is project an unofficial, community effort, that seeks to implement replication (which is currently not a part of the core Pi-hole product) in a way that provides stability and value to Pi-hole users. The code has been tested across multiple user environments but there always is an element of risk involved with running any arbitrary software you find on the Internet.

Pi-hole is and the Pi-hole logo are registered trademarks of Pi-hole LLC.

Additional Documentation

Please refer to the Wiki for more information: