PunktfunkPunktfunk

Arch Linux

Install the Punktfunk host on Arch, CachyOS or EndeavourOS from the signed pacman repo, in four steps.

Install the host on Arch Linux and Arch-based distros such as CachyOS and EndeavourOS. Omarchy and SteamOS have their own pages: Omarchy, SteamOS.

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 driver

  • NVIDIA: sudo pacman -S --needed nvidia-utils. NVENC comes from it.
  • AMD / Intel: the Mesa stack a desktop usually has already: vulkan-radeon or vulkan-intel for Vulkan Video, libva-mesa-driver or intel-media-driver for VAAPI.

2. Install the host

Trust the repo key, add the repo, and install the host, the console and the plugin runner. Always use a full -Syu: the packages are built against current Arch libraries, and a partial upgrade breaks them.

curl -fsS https://git.unom.io/api/packages/unom/arch/repository.key | sudo pacman-key --add -sudo pacman-key --lsign-key E0CA04465C99C936E0B0C6510A317015A34DDD69grep -q '^\[punktfunk\]' /etc/pacman.conf || printf '\n[punktfunk]\nServer = https://git.unom.io/api/packages/unom/arch/$repo/$arch\n' | sudo tee -a /etc/pacman.conf >/dev/nullsudo pacman -Syu punktfunk-host punktfunk-web punktfunk-scripting

sudo pacman -Syu updates every Punktfunk package from then on and restarts the running services, or let the console update it.

3. Let it use your controllers

Join the groups, then restart the computer:

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

4. Start it

From a terminal inside your desktop session. The install already enabled the plugin runner for every user; this starts it with the host and the console:

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

Stock Arch has no firewall. CachyOS enables ufw and EndeavourOS enables firewalld; open the host, and the console for other devices:

# ufw (CachyOS)
sudo ufw allow punktfunk-native && sudo ufw allow punktfunk-web
# firewalld (EndeavourOS)
sudo firewall-cmd --reload
sudo firewall-cmd --permanent --add-service=punktfunk-native --add-service=punktfunk-web
sudo firewall-cmd --reload

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

More

On this page