PunktfunkPunktfunk

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.

PlanePortWhatfirewalld service / ufw profile
Native controlUDP 9777QUIC: control, video and audiopunktfunk-native
DiscoveryUDP 5353mDNS discoverypunktfunk-native
Management APITCP 47990management REST API (HTTPS + token; read-only status/library off loopback)punktfunk-native
Browser streamingUDP 9778browser streaming (preview, off until switched on)punktfunk-native
Web consoleTCP 47992, 47993web console (HTTPS, login-gated); plugin interfaces on 47993punktfunk-web
GameStream (Moonlight)TCP 47984, 47989, 48010 · UDP 47998, 47999, 48000GameStream/Moonlight-compat planes (opt-in, PUNKTFUNK_GAMESTREAM=1)punktfunk-gamestream
  • punktfunk-native is all a default host needs: paired clients, discovery and the management API.
  • punktfunk-web only when you open the console from another device. Plugin interfaces use its second port — see Two ports, not one.
  • punktfunk-gamestream only 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-native too: 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, or sudo 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
SystemFirewall as shipped
Fedora, Bazzite, most Fedora spins, EndeavourOSfirewalld, on
CachyOSufw, on
Ubuntuufw, installed but off
Arch, Debiannone
NixOSopenFirewall = true in the module opens the ports
Windowsservice 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.

PortSettingClients
Management APIPUNKTFUNK_MGMT_BIND=IP:PORTRelearn it from discovery. The console, plugin runner and tray read it from mgmt-endpoint, which the host rewrites on every start.
Native controlPUNKTFUNK_NATIVE_PORTRelearn it over mDNS. A host added by address keeps the port it was added with. Video moves with it.
Browser clientPUNKTFUNK_WEBTRANSPORT_PORTDefault 9778.

On this page