Skip to content

docs: add Docker Swarm HA guide for self-hosted Enterprise#829

Draft
SunsetDrifter wants to merge 2 commits into
mainfrom
docs/docker-swarm-ha
Draft

docs: add Docker Swarm HA guide for self-hosted Enterprise#829
SunsetDrifter wants to merge 2 commits into
mainfrom
docs/docker-swarm-ha

Conversation

@SunsetDrifter

Copy link
Copy Markdown
Contributor

Summary

Adds a new guide at /selfhosted/enterprise/docker-swarm: Running NetBird HA on Docker Swarm. It is a companion to Running a Highly Available Self-Hosted Deployment and covers only what changes when that architecture runs on Docker Swarm instead of plain VMs:

  • Why Swarm's routing mesh and default service networking (endpoint_mode: vip) don't fit the HA architecture, and what fills the gaps (Traefik for the application pools, HAProxy for PostgreSQL/Redis primary routing)
  • Swarm-native PostgreSQL (Patroni/Spilo + etcd) and Redis (Sentinel) clusters, including the endpoint_mode: dnsrr requirement and other non-obvious pitfalls
  • Full docker service create commands for all pools, Traefik labels for the gRPC/HTTP split, and an end-to-end failover verification checklist with measured expectations

Second commit is a separate grammar/readability editing pass over the new page.

Notes for review

  • The page is intentionally not added to NavigationDocs.jsx — it should remain unlisted for now. It will still appear in sitemap.xml/llms.txt since those generators scan src/pages/ directly.
  • New image asset: public/docs-static/img/selfhosted/enterprise/docker-swarm-ha-topology.png (uses the standard imagewrapper-big zoom class).
  • All cross-page anchor links target the main HA guide and were checked against its actual heading slugs.

@coderabbitai

coderabbitai Bot commented Jul 6, 2026

Copy link
Copy Markdown
Contributor

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 3789efe7-c16d-4442-b5f2-8c43ca7a66b4

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • ✅ Review completed - (🔄 Check again to review again)
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/docker-swarm-ha

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

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