{"name":"nebula-sync: Effortlessly Synchronize Your Pi-hole Configurations","description":"nebula-sync is a powerful tool designed to synchronize configurations across multiple Pi-hole v6.x instances. Developed in Go, it offers both full and selective synchronization options, ensuring your ad-blocking setup remains consistent and up-to-date across your network. This project simplifies the management of distributed Pi-hole deployments.","github":"https://github.com/lovelaze/nebula-sync","url":"https://osrepos.com/repo/lovelaze-nebula-sync","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/lovelaze-nebula-sync","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/lovelaze-nebula-sync.md","json":"https://osrepos.com/repo/lovelaze-nebula-sync.json","topics":["dns","docker","golang","pi-hole","replication","sync","network-management","system-administration"],"keywords":["dns","docker","golang","pi-hole","replication","sync","network-management","system-administration"],"stars":null,"summary":"nebula-sync is a powerful tool designed to synchronize configurations across multiple Pi-hole v6.x instances. Developed in Go, it offers both full and selective synchronization options, ensuring your ad-blocking setup remains consistent and up-to-date across your network. This project simplifies the management of distributed Pi-hole deployments.","content":"## Introduction\n\nManaging multiple Pi-hole instances can be a challenge, especially when striving for consistent configurations across all your devices. `nebula-sync` addresses this by providing a robust solution to synchronize settings between your primary Pi-hole v6.x instance and its replicas. Built in Go, this community-maintained project offers flexible synchronization options, from full Teleporter imports to granular control over specific settings, making multi-Pi-hole management significantly easier.\n\n## Installation\n\n`nebula-sync` offers several convenient installation methods to get you started:\n\n### Linux/OSX binary\n\nDownload the binary from the [latest release](https://github.com/lovelaze/nebula-sync/releases/latest) or build from source:\n\nbash\ngo install github.com/lovelaze/nebula-sync@latest\n\n\nRun the binary:\n\nbash\n# run\nnebula-sync run\n\n# read envs from file\nnebula-sync run --env-file .env\n\n\n### Docker Compose (recommended)\n\nyaml\n---\nservices:\n  nebula-sync:\n    image: ghcr.io/lovelaze/nebula-sync:latest\n    container_name: nebula-sync\n    environment:\n    - PRIMARY=http://ph1.example.com|password\n    - REPLICAS=http://ph2.example.com|password,http://ph3.example.com|password\n    - FULL_SYNC=true\n    - RUN_GRAVITY=true\n    - CRON=0 * * * *\n\n\n### Docker CLI\n\nbash\ndocker run --rm \\\n  --name nebula-sync \\\n  -e PRIMARY=\"http://ph1.example.com|password\" \\\n  -e REPLICAS=\"http://ph2.example.com|password\" \\\n  -e FULL_SYNC=true \\\n  -e RUN_GRAVITY=true \\\n  ghcr.io/lovelaze/nebula-sync:latest\n\n\n## Examples\n\nFor practical configuration examples, including environment variables and Docker Compose setups, refer to the `examples` directory within the repository. Additionally, `nebula-sync` supports webhooks, allowing you to integrate with services like healthcheck.io or Apprise for notifications on sync success or failure. Detailed webhook configuration examples are available in the project's README.\n\n## Why Use nebula-sync?\n\n`nebula-sync` is an invaluable tool for anyone running multiple Pi-hole instances. It eliminates the tedious manual process of updating each Pi-hole individually, ensuring all your ad-blocking and DNS configurations are identical across your network. Key features include:\n\n*   **Full Sync**: Utilize Pi-hole's Teleporter for comprehensive synchronization of all settings.\n*   **Selective Sync**: Gain granular control by synchronizing only specific features, such as DNS settings, ad lists, or client configurations.\n*   **Cron Schedule**: Automate your synchronization tasks by setting up a cron schedule, ensuring your Pi-hole replicas are always up-to-date without manual intervention.\n\n## Links\n\n*   **GitHub Repository**: [https://github.com/lovelaze/nebula-sync](https://github.com/lovelaze/nebula-sync)","metrics":{"detailViews":4,"githubClicks":5},"dates":{"published":null,"modified":"2026-05-02T11:06:11.000Z"}}