Skip to content

Document the HA cluster - #1429

Open
DL6ER wants to merge 4 commits into
masterfrom
new/cluster
Open

DL6ER wants to merge 4 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.

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

netlify Bot commented Sep 5, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for pihole-docs ready!

Name Link
🔨 Latest commit 9e8c10f
🔍 Latest deploy log https://app.netlify.com/projects/pihole-docs/deploys/6ad8ed395d30003b9b30a538
😎 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>
@DL6ER
DL6ER marked this pull request as ready for review October 17, 2026 18:56
@DL6ER
DL6ER requested a review from a team as a code owner October 17, 2026 18:56
Copilot AI balanced review requested due to automatic review settings October 17, 2026 18:56

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

DL6ER added 2 commits October 20, 2026 20:10
…quired fingerprint

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.

2 participants