Ports & firewall
Every port a Punktfunk host and its console use, the firewall profile that opens each, and how to move one.
Find the port a Punktfunk host uses, the firewall profile that opens it, and how to move it. The Linux packages install firewalld services and ufw profiles but never enable them.
| Plane | Port | What | firewalld service / ufw profile |
|---|---|---|---|
| Native control | UDP 9777 | QUIC: control, video and audio | punktfunk-native |
| Discovery | UDP 5353 | mDNS discovery | punktfunk-native |
| Management API | TCP 47990 | management REST API (HTTPS + token; read-only status/library off loopback) | punktfunk-native |
| Browser streaming | UDP 9778 | browser streaming (preview, off until switched on) | punktfunk-native |
| Web console | TCP 47992, 47993 | web console (HTTPS, login-gated); plugin interfaces on 47993 | punktfunk-web |
| GameStream (Moonlight) | TCP 47984, 47989, 48010 · UDP 47998, 47999, 48000 | GameStream/Moonlight-compat planes (opt-in, PUNKTFUNK_GAMESTREAM=1) | punktfunk-gamestream |
punktfunk-nativeis all a default host needs: paired clients, discovery and the management API.punktfunk-webonly when you open the console from another device. Plugin interfaces use its second port — see Two ports, not one.punktfunk-gamestreamonly with Moonlight compat on.- Video needs no port of its own. It rides the native QUIC port with control and audio.
- The browser client (preview, off by default) uses the browser streaming port, in
punktfunk-native— see Browser Client. - Seats use UDP 9779–9782, in
punktfunk-nativetoo: a host that places a profile on a seat redirects the client to that seat's port. With browser streaming on, a browser goes to the seat's own browser port, UDP 9783–9786. - After an update that adds ports to a profile, refresh the rules:
sudo ufw app update punktfunk-native && sudo ufw reload, orsudo firewall-cmd --reload.
Enable the profiles
sudo firewall-cmd --reload # load the definitions the package installed
sudo firewall-cmd --permanent --add-service=punktfunk-native --add-service=punktfunk-web
sudo firewall-cmd --permanent --add-service=punktfunk-gamestream # only with Moonlight compat on
sudo firewall-cmd --reload| System | Firewall as shipped |
|---|---|
| Fedora, Bazzite, most Fedora spins, EndeavourOS | firewalld, on |
| CachyOS | ufw, on |
| Ubuntu | ufw, installed but off |
| Arch, Debian | none |
| NixOS | openFirewall = true in the module opens the ports |
| Windows | service install adds the rules |
On Windows each rule names the Punktfunk executable as well as the port. The rules cover
Private and Domain networks; service install --allow-public-network adds Public — see
Host CLI. Another program that answered discovery through
Punktfunk's discovery rule needs a rule of its own. The browser client's rule, Punktfunk
Browser (the browser streaming port, and each seat's UDP 9783–9786), exists only while Browser
streaming is on: the service adds or removes it each time it starts the host, so it follows the
setting at Restart Punktfunk.
Who can reach the console
The web console and its plugin port answer this machine, private and link-local addresses, and a
Tailscale or NetBird network. A peer from the internet is refused even with the
port forwarded. PUNKTFUNK_UI_BIND=127.0.0.1 in host.env keeps both to this machine; one address
limits them to one interface.
NetBird counts on its default interface, wt0. Any other VPN that hands out 100.64/10 addresses
counts as the internet, here and for pairing.
Moving a port
Set these in host.env. Moving the management port is how you share a
machine with Sunshine — see Switching from Sunshine.
| Port | Setting | Clients |
|---|---|---|
| Management API | PUNKTFUNK_MGMT_BIND=IP:PORT | Relearn it from discovery. The console, plugin runner and tray read it from mgmt-endpoint, which the host rewrites on every start. |
| Native control | PUNKTFUNK_NATIVE_PORT | Relearn it over mDNS. A host added by address keeps the port it was added with. Video moves with it. |
| Browser client | PUNKTFUNK_WEBTRANSPORT_PORT | Default 9778. |