PVE Sync¶

The PVE Sync tool is used to trigger synchronization tasks across Proxmox nodes and verify configuration consistency for AdGuard Home and Traefik.

Installation¶

The sync script is located in scripts/pve_sync.py. It requires python3.

Usage¶

:simple-gemini: Gemini CLI¶

You can trigger the sync process via the Gemini CLI:

/pve sync

Manual Execution¶

Alternatively, you can run the script directly:

python3 scripts/pve_sync.py

How it Works¶

1. AdGuard Home Sync: Restarts the adguardhome-sync.service on the master node to trigger a synchronization of DNS rewrites and filters to replica instances.
2. Traefik Consistency: Scans the pve/traefik/conf.d/ directory in the repository and (manually or via future automation) verifies that these files exist and match on all Proxmox nodes.
3. DNS Rewrite Verification: Encourages manual verification of DNS rewrites across all AdGuard Home instances using the manage_dns tool.

References¶

• AdGuard Home Sync
• Traefik File Provider