pihole-opnsense-sync/README.md

pihole-opnsense-sync

Sync custom DNS entries in Pi-hole to OPNsense Unbound.

Install

1. Install pip requirements:

   pip install -r requirements.txt
   

2. Create your secrets file at /etc/secrets/pihole-opnsense-sync with your API details:

   OPNSENSE_API_KEY='...'
   OPNSENSE_API_SECRET='...'
   

3. Set the permissions on this file:

   sudo chown root:root /etc/secrets/pihole-opnsense-sync
   sudo chmod 600 /etc/secrets/pihole-opnsense-sync
   

4. Copy the systemd service file:

   sudo cp pihole-opnsense-sync.service /etc/systemd/system/pihole-opnsense-sync.service
   

5. Enable and start the service:

   sudo systemctl enable --now pihole-opnsense-sync
   sudo systemctl status pihole-opnsense-sync