Skip to content

Document the HA cluster - #1429

Draft
DL6ER wants to merge 2 commits into
masterfrom
new/cluster
Draft

DL6ER wants to merge 2 commits into
masterfrom
new/cluster

Conversation

@DL6ER

@DL6ER DL6ER commented Sep 5, 2026 •

Copy link
Copy Markdown
Member

Documentation for native HA clustering in FTL (pi-hole/FTL#3069): what a cluster keeps in step and what it deliberately does not, building one from the web interface or by hand, DHCP failover and the leases that travel with it, the virtual IP address, how the nodes authenticate and recognize each other's certificates, what happens across versions and rollbacks, and a Docker example. compile.md notes that building FTL now needs libcurl.

The page itself is pi-hole/web#3864. Draft on purpose: the whole feature is slated to go in after v7.0.

@DL6ER DL6ER mentioned this pull request Sep 5, 2026
4 of 5 tasks
@netlify

netlify Bot commented Sep 5, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for pihole-docs ready!

Name Link
🔨 Latest commit 12ccbdf
🔍 Latest deploy log https://app.netlify.com/projects/pihole-docs/deploys/6aa1a061851f3300083a0704
😎 Deploy Preview https://deploy-preview-1429--pihole-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

The cluster nodes talk to each other over the API they already serve,
which means FTL links against libcurl - and the from-source instructions
did not say so.

Signed-off-by: DL6ER <dl6er@dl6er.de>
Several Pi-holes keeping their configuration and their lists in step,
handing DHCP over when one of them fails, and moving a virtual IP address
between them.

Covers what does and does not travel between the nodes and why, how they
authenticate each other, what joining and leaving really do, what happens
when the nodes cannot see each other or are on different versions, and a
three-container compose file for trying it out.

Signed-off-by: DL6ER <dl6er@dl6er.de>

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant