Skip to content

Add WireGuard port conflict troubleshooting for Domain Controllers#660

Merged
SunsetDrifter merged 1 commit intomainfrom
docs/wireguard-port-conflict-domain-controllers
Mar 18, 2026
Merged

Add WireGuard port conflict troubleshooting for Domain Controllers#660
SunsetDrifter merged 1 commit intomainfrom
docs/wireguard-port-conflict-domain-controllers

Conversation

@SunsetDrifter
Copy link
Contributor

@SunsetDrifter SunsetDrifter commented Mar 18, 2026

Summary

  • Add a new "WireGuard Port Conflict on Domain Controllers" subsection to the Active Directory & Domain Controllers section in the internal DNS servers page
  • Documents the issue where Windows DNS Server claims UDP port 51820, causing NetBird to fail with a DeadlineExceeded error
  • Covers symptoms, diagnosis steps (netstat, tasklist, debug bundle), and the dnscmd fix to exclude the port from the DNS socket pool

Test plan

  • npm run build passes
  • Verify rendered page at /manage/dns/internal-dns-servers#wireguard-port-conflict-on-domain-controllers
  • Confirm dnscmd command works on a Windows Domain Controller with DNS Server role

Document the issue where Windows DNS Server claims UDP port 51820,
preventing WireGuard from starting on Domain Controllers. Covers
symptoms, diagnosis steps, and the dnscmd fix.
Copy link
Contributor

@emrcbrn emrcbrn left a comment

Choose a reason for hiding this comment

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

LGTM

@SunsetDrifter SunsetDrifter merged commit ab4dea9 into main Mar 18, 2026
1 check passed
@SunsetDrifter SunsetDrifter deleted the docs/wireguard-port-conflict-domain-controllers branch March 18, 2026 09:23
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