Ubuntu

Install the host on Ubuntu 26.04 or newer, Desktop or Server. Ubuntu 24.04 installs the package but can't stream: its desktop is too old (Requirements).

One command instead? The guided installer (preview) does steps 2 to 4 and warns when step 1 is missing:

curl -fsSL https://punktfunk.unom.io/install.sh | sh

1. GPU driverCopy Anchor Link

• NVIDIA: install the recommended driver and its GL/EGL userspace, which Wayland needs, then reboot:

  Copy Text

  sudo ubuntu-drivers install
  sudo apt install libnvidia-gl-<version>   # the number ubuntu-drivers picked, e.g. 580

  If nvidia-smi can't reach the driver afterwards, Secure Boot is blocking it: Troubleshooting.

• AMD / Intel: nothing to install. The host package pulls in the VAAPI drivers, and Mesa carries Vulkan Video.

2. Install the hostCopy Anchor Link

Add the repo and install the host, the console and the plugin runner:

sudo install -d -m 0755 /etc/apt/keyringscurl -fsSL https://git.unom.io/api/packages/unom/debian/repository.key | sudo tee /etc/apt/keyrings/punktfunk.asc >/dev/nullecho "deb [signed-by=/etc/apt/keyrings/punktfunk.asc] https://git.unom.io/api/packages/unom/debian stable main" | sudo tee /etc/apt/sources.list.d/punktfunk.listsudo apt updatesudo apt install punktfunk-host punktfunk-web punktfunk-scripting

sudo apt upgrade updates it from then on. Restart the host afterwards with systemctl --user restart punktfunk-host, or let the console update it.

3. Let it use your controllersCopy Anchor Link

Join the groups, then log out and back in:

sudo usermod -aG input "$USER"       # virtual gamepads
sudo usermod -aG punktfunk "$USER"   # virtual Steam Deck controller

4. Start itCopy Anchor Link

From a terminal inside your desktop session:

systemctl --user enable --now punktfunk-host punktfunk-web

Ubuntu ships ufw turned off. If you turned it on, open the host, and the console for other devices:

sudo ufw allow punktfunk-native && sudo ufw allow punktfunk-web

Next: Quick Start, step 3: open the console and pair a device.

MoreCopy Anchor Link

• Your desktop: KDE, GNOME, gamescope, Hyprland, Sway.
• Stream with nobody logged in: Running as a service.
• Every port and firewall profile: Ports & firewall.