SVI/netbird
1
0
Fork 0
mirror of https://github.com/netbirdio/netbird.git synced 2026-05-13 11:41:58 -04:00
Code Issues 3.0k Packages Projects Releases 10 Wiki Activity

Clarify required ports and Caddy port bindings in self-hosted NetBird docs #2026

New Issue
Closed
opened 2025-11-20 06:11:28 -05:00 by saavagebueno · 2 comments
saavagebueno commented 2025-11-20 06:11:28 -05:00
Owner
Copy Link

Originally created by @baltazartroisville on GitHub (Jun 28, 2025).

Hello NetBird team and other readers,

First off, thank you for all the hard work on NetBird!

I’ve been setting up the self-hosted environment over the last couple of days and ran into a few confusing discrepancies in the documentation and generated compose files:

  1. Unlisted ports (33073, 10000, 33080)

    • The self-hosted docs say tcp ports 33073, 10000, and 33080 must be open.
    • In practice I only see 10000 referenced (and only internally in the Caddyfile).
    • None of the compose services actually map to 33073, 10000 or 33080.
      Question: Are those three ports truly required? If so, which containers/services use them and why?

  2. Coturn port mismatch

    • Coturn’s own docs list these required ports:
      • 3478 TCP & UDP
      • 5349 TCP & UDP
      • A configurable UDP range (for relayed media)
    • NetBird’s docs only mention 3478 UDP and the UDP range.
    • The default turnserver.conf in the repo maps 3478 for unencrypted and 5349 for encrypted—but doesn’t specify protocol.
      Question: Should coturn be listening on both TCP and UDP for 3478 and 5349? Please clarify which protocols are required.

  3. Caddy port 8080 mapping

    • The generated Docker Compose maps container port 8080 → host port 8080 for Caddy.
    • However, the supplied Caddyfile only binds :80 and :443 tcp/udp.
      Question: Is there a hidden listener on 8080 I’m missing, or is this line vestigial and safe to remove?

Thanks in advance for any clarification. Have a great weekend! ❤

Originally created by @baltazartroisville on GitHub (Jun 28, 2025). Hello NetBird team and other readers, First off, thank you for all the hard work on NetBird! I’ve been setting up the self-hosted environment over the last couple of days and ran into a few confusing discrepancies in the documentation and generated compose files: 1. **Unlisted ports (33073, 10000, 33080)** - The self-hosted docs say tcp ports 33073, 10000, and 33080 must be open. - In practice I only see 10000 referenced (and only internally in the Caddyfile). - None of the compose services actually map to 33073, 10000 or 33080. **Question:** Are those three ports truly required? If so, which containers/services use them and why? 2. **Coturn port mismatch** - Coturn’s own docs list these required ports: - 3478 TCP & UDP - 5349 TCP & UDP - A configurable UDP range (for relayed media) - NetBird’s docs only mention 3478 UDP and the UDP range. - The default `turnserver.conf` in the repo maps 3478 for unencrypted and 5349 for encrypted—but doesn’t specify protocol. **Question:** Should coturn be listening on both TCP and UDP for 3478 and 5349? Please clarify which protocols are required. 3. **Caddy port 8080 mapping** - The generated Docker Compose maps container port 8080 → host port 8080 for Caddy. - However, the supplied `Caddyfile` only binds `:80` and `:443` tcp/udp. **Question:** Is there a hidden listener on 8080 I’m missing, or is this line vestigial and safe to remove? Thanks in advance for any clarification. Have a great weekend! ❤
saavagebueno added the questionmissing-docsself-hosting labels 2025-11-20 06:11:28 -05:00
saavagebueno commented 2025-11-20 06:11:29 -05:00
Author
Owner
Copy Link

@nazarewk commented on GitHub (Jun 30, 2025):

TLDR; this is correct:

  • The VM should be publicly accessible on TCP ports 80, 443; and UDP ports: 3478, 49152-65535.

Unlisted ports (33073, 10000, 33080)

  • The self-hosted docs say tcp ports 33073, 10000, and 33080 must be open.

  • In practice I only see 10000 referenced (and only internally in the Caddyfile).

  • None of the compose services actually map to 33073, 10000 or 33080.
    Question: Are those three ports truly required? If so, which containers/services use them and why?

Those are ports for very old clients, not sure exactly which versions, but at least a few months old.

Coturn port mismatch

  • Coturn’s own docs list these required ports:

    • 3478 TCP & UDP
    • 5349 TCP & UDP
    • A configurable UDP range (for relayed media)

  • NetBird’s docs only mention 3478 UDP and the UDP range.

  • The default turnserver.conf in the repo maps 3478 for unencrypted and 5349 for encrypted—but doesn’t specify protocol.
    Question: Should coturn be listening on both TCP and UDP for 3478 and 5349? Please clarify which protocols are required.

I don't know the exact details, but the team mentioned only those UDP ports being required: 3478 & 49152-65535 .

  • Question: Is there a hidden listener on 8080 I’m missing, or is this line vestigial and safe to remove?

I think it might be some kind of old version and/or debugging leftover, but asked the team for clarification.

@nazarewk commented on GitHub (Jun 30, 2025): TLDR; this is correct: - The VM should be publicly accessible on TCP ports 80, 443; and UDP ports: 3478, 49152-65535. --- > **Unlisted ports (33073, 10000, 33080)** > > * The self-hosted docs say tcp ports 33073, 10000, and 33080 must be open. > > * In practice I only see 10000 referenced (and only internally in the Caddyfile). > > * None of the compose services actually map to 33073, 10000 or 33080. > **Question:** Are those three ports truly required? If so, which containers/services use them and why? Those are ports for very old clients, not sure exactly which versions, but at least a few months old. > **Coturn port mismatch** > > * Coturn’s own docs list these required ports: > > * 3478 TCP & UDP > * 5349 TCP & UDP > * A configurable UDP range (for relayed media) > > * NetBird’s docs only mention 3478 UDP and the UDP range. > > * The default `turnserver.conf` in the repo maps 3478 for unencrypted and 5349 for encrypted—but doesn’t specify protocol. > **Question:** Should coturn be listening on both TCP and UDP for 3478 and 5349? Please clarify which protocols are required. I don't know the exact details, but the team mentioned only those `UDP` ports being required: `3478` & `49152-65535` . > * **Question:** Is there a hidden listener on 8080 I’m missing, or is this line vestigial and safe to remove? I think it might be some kind of old version and/or debugging leftover, but asked the team for clarification.
saavagebueno commented 2025-11-20 06:11:29 -05:00
Author
Owner
Copy Link

@nazarewk commented on GitHub (Jun 30, 2025):

We have PRs merged/pending review, so I'll close this as completed:

@nazarewk commented on GitHub (Jun 30, 2025): We have PRs merged/pending review, so I'll close this as completed: - https://github.com/netbirdio/docs/pull/384 - https://github.com/netbirdio/netbird/pull/4075
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
2021 Q4
2022 Q1
2022 Q1
accessibility
acl
agent
agent
Android
Android
api
authentik
automation
azure
battery-usage
bug
cache
client
client-ui
cloud
cloud-only
cloudflare
community
compatibility
config-idp
config-issue
connection
contribution
coturn
cross-vpn
dashboard
data-usage
distribution
dns
docker
documentation
duplicate
enhancement
enhancement
event-stream
feature-request
freebsd
getting-started
go
good first issue
gui
help wanted
home-assistant
idp
inconsistency
integration
integrations
ios
ipv6
jwt
k8s
keycloak
linux
login
macos
management-service
missing-docs
mobile
moved-internal
needs-review
netbird-ui
networking
new-platform
nginx
notification
okta
openwrt
packaging
peer-management
peer-management
peer-management
performance
postgres
posture-checks
psk
pull-request
Mirrored from GitHub Pull Request
 question
refactor
relay
release
rfc
routes
security
security-related
self-hosting
server
signal
sleep-issue
ssh
ssl
status
store
synology
system-compatibility-issue
test-suite
third-party-integration
triage
triage-needed
troubleshooting
UX
waiting-feedback
windows
wontfix
zitadel
No Label missing-docs question self-hosting
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
saavagebueno
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: SVI/netbird#2026
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?