Skip to content

Document static peer ports for site-to-site firewall rules - #948

Merged
SunsetDrifter merged 1 commit into
mainfrom
cc/static-peer-ports
Aug 25, 2026
Merged

Document static peer ports for site-to-site firewall rules#948
SunsetDrifter merged 1 commit into
mainfrom
cc/static-peer-ports

Conversation

@SunsetDrifter

Copy link
Copy Markdown
Contributor

What

Adds a "Static peer ports for site-to-site firewall rules" section to Ports & Firewalls, answering a recurring customer question: branch offices with strict egress policies need firewall rules toward main locations that stay valid, but the remote port shown in the ICE candidate endpoints is a dynamic NAT mapping and can be reassigned.

How

The section explains why the observed remote port must not be used in firewall rules, then gives an outbound-first recipe:

  1. Pin a distinct WireGuard port per peer at the main location (netbird up --wireguard-port), allocated from a range sized up front.
  2. Preferred: a port-preserving source NAT mode at the main site (Static Port / Endpoint-Independent NAT / Persistent DIPP) plus a raised UDP session timeout, keeping everything outbound. A static DNAT per peer is documented only as the last resort when the firewall cannot preserve ports.
  3. One stable outbound UDP range rule per branch, which never changes when peers are added at the main site.

A scoping note keeps the pattern narrow: controlled sites only, not for roaming devices, and not a general fix for relayed connections.

Also:

  • Renames the "Incoming ports" / "Outgoing ports" headings to "Inbound ports" / "Outbound ports" and aligns body wording, matching the terminology the rest of the page and docs already use (internal anchor links updated; UFW's quoted default-policy wording left as-is).
  • Cross-links the new section from the port-forwarding note on the relayed-connections troubleshooting page.

@vercel

vercel Bot commented Aug 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 25, 2026 10:20am

Request Review

@coderabbitai

coderabbitai Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Warning

Review limit reached

Next included review available in 48 minutes.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 253189cf-99f4-410a-9b5f-82842e476bd5

📥 Commits

Reviewing files that changed from the base of the PR and between 60e1817 and fad6f2f.

📒 Files selected for processing (2)
  • src/pages/about-netbird/ports-and-firewalls.mdx
  • src/pages/help/troubleshooting-relayed-connections.mdx

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.

Branch offices with strict egress policies need stable outbound rules
toward main locations. Documents pinning --wireguard-port per peer plus
a static DNAT at the main site, with the no-inbound trade-off stated
and scoped, and cross-links from Incoming ports and the relayed-
connections troubleshooting note.
@SunsetDrifter
SunsetDrifter merged commit bc77c3a into main Aug 25, 2026
5 checks passed
@SunsetDrifter
SunsetDrifter deleted the cc/static-peer-ports branch August 25, 2026 10:35
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