enricobuehler
9f049f965f
- install (host): add a Windows (NVIDIA) section with signed-installer and certificate-trust steps; note the .cer is the same across releases. - install-client: clarify the Windows MSIX certificate is the same every release (trust once, updates need nothing). - Move "Project & Internals" out of the public docs site: relocate implementation-plan, apple-stage2-presenter, gamescope-multiuser, dualsense-haptics, ci, and gamestream-host-plan to docs/; drop them from the nav. Move windows-host into Host Setup. - Rewrite roadmap as a lean public page with an at-a-glance grid and current statuses (Windows host shipped/beta, Apple incl. tvOS shipped, Android shipped, concurrent sessions + delegated pairing done). - Fix status.md link to the now-internal implementation plan. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
4.4 KiB
title, description
| title | description |
|---|---|
| Install the Host | Install the punktfunk host — on Linux from its package registry, or on Windows from a signed installer. |
On Linux, the package registries are the real distribution channel. Pick your distro, add the repo, and install with your native package manager. Each row links to the full per-distro guide (add the repo, first-run steps, the web console) — those are the source of truth, so this page doesn't duplicate them. On Windows (NVIDIA), the host ships as a signed installer instead — see Windows.
Pick your distro
| Distro | Package manager | One-command happy path | Guide |
|---|---|---|---|
| Ubuntu / Debian | apt | sudo apt install punktfunk-host |
Ubuntu — GNOME · Ubuntu — KDE · packaging/debian |
| Fedora / Bazzite | rpm-ostree | rpm-ostree install punktfunk punktfunk-web |
Fedora — KDE · Bazzite · packaging/rpm |
| Arch / Steam Deck | PKGBUILD / sysext | makepkg -si (Arch) · sysext .raw (SteamOS/Deck) |
packaging/arch |
Each registry is public — no auth, you just trust the repo's signing key. Adding the repo is a
one-time step covered in the linked guide; after that, normal apt upgrade / rpm-ostree upgrade
tracks new builds automatically.
Windows (NVIDIA)
punktfunk also runs as a native host on Windows 10/11 (x64) with an NVIDIA GPU, shipped as a signed installer — see Windows Host for what it includes and its limitations.
-
From the packages page (generic group), download the newest
punktfunk-host-setup-<ver>.exeand its matching.cer. -
Trust the publisher certificate once. The installer is signed with a self-signed certificate whose public
.ceris published next to it — the same certificate for every release, so this is genuinely one-time and later updates need nothing. In an admin PowerShell:Import-Certificate -FilePath .\punktfunk-host-setup.cer ` -CertStoreLocation Cert:\LocalMachine\TrustedPublisher -
Run
punktfunk-host-setup-<ver>.exe(elevated). It installs toC:\Program Files\punktfunk, optionally installs the bundled SudoVDA virtual-display driver, and registers + starts theLocalSystemservice (/VERYSILENTfor an unattended install). Upgrades and uninstall go through Add/Remove Programs.
You need an NVIDIA GPU + driver (the host is NVENC-only on Windows). More detail — including the CLI
punktfunk-host service install path — is in
Running as a Service → Windows.
What the packages are
punktfunk-host— the streaming host. Install this on your Linux + NVIDIA gaming machine.punktfunk-web— the browser management console (pairing + status). Recommended alongside the host; on RPM list it explicitly (rpm-ostree install punktfunk punktfunk-web).punktfunk-client— the GTK4 desktop client, for streaming to a Linux box (also shipped via apt / RPM / Arch / Flatpak). On a Steam Deck, this is the package you want.
After installing
-
Add yourself to the
inputgroup (virtual gamepads need/dev/uinput), then re-login. The exact command differs per distro — see your guide (usermod -aG input "$USER", orujust add-user-to-input-groupon Bazzite). -
Start the host inside your desktop session:
punktfunk-host serve --native -
Enable the web console and read its login password, then open
http://<host-ip>:3000:systemctl --user enable --now punktfunk-web journalctl --user -u punktfunk-web-init | sed -n 's/.*password generated: //p'
From there, follow the Quick Start to pair your first client. To run the host automatically at boot, see Running as a Service.
Building from source
If no package exists for your platform, you can build from source — see the repository README. Source builds are a fallback; the registries are the supported path.