Install & startup

Fixes for a host that won't install or start. A Linux host service that fails and nvidia-smi errors are on Troubleshooting.

LinuxCopy Anchor Link

systemctl --user status punktfunk-web: unit not foundCopy Anchor Link

The console is its own package, and installing only the host can leave it out. Install it by name and start it:

sudo apt install punktfunk-web      # Debian, Ubuntu
sudo dnf install punktfunk-web      # Fedora
sudo pacman -S punktfunk-web        # Arch
systemctl --user enable --now punktfunk-web

On Fedora, No match for argument means the COPR repo, which has no console. Use the repo from Fedora. Then read the login password.

pacman: error: could not register 'punktfunk' database (database already registered)Copy Anchor Link

The [punktfunk] block is in /etc/pacman.conf twice. It's harmless; delete the second block.

The desktop won't start, or "GPU … not supported by EGL"Copy Anchor Link

The NVIDIA GL/EGL userspace package is missing. Install it and check its vendor file: GNOME → The GL/EGL userspace.

The session fails right after editing host.envCopy Anchor Link

A key is misspelled, or a line points the host at the wrong session. The host reads host.env only when it starts, so restart after every edit: systemctl --user restart punktfunk-host.

• Keys are case-sensitive: punktfunk_gamescope_attach=1 sets nothing.
• XDG_RUNTIME_DIR=/run/user/1000 on a box where id -u isn't 1000 points the host at another user's session. Delete the session anchors; the service doesn't need them.
• PUNKTFUNK_COMPOSITOR pins one backend and stops the host following Game Mode ↔ Desktop. Remove it on a box that switches sessions.

WindowsCopy Anchor Link

Windows: the host or the web console won't startCopy Anchor Link

The PunktfunkHost service runs both and restarts either one that stops. Check it from an elevated PowerShell:

punktfunk-host service status
punktfunk-host service restart

• Two punktfunk-host.exe processes are normal: one supervises, one streams in your session. Don't end either.
• If the console page stays down, read its log from the elevated PowerShell: Get-Content -Tail 50 $env:ProgramData\punktfunk\logs\web.log.

Windows: the status icon is missing after an updateCopy Anchor Link

The host starts the tray again within a minute of restarting, unless Tray autostart is off under Host → System. To start it now, from a normal PowerShell, not an elevated one:

punktfunk-host tray start