Compare commits

...
1 Commits
Author SHA1 Message Date
enricobuehler b9adcc4897 fix(docs): the Fedora install line must name punktfunk-web, not hope for it
ci / docs-drift (pull_request) Successful in 29s
ci / bun-nix (pull_request) Successful in 29s
ci / web (pull_request) Successful in 1m8s
ci / docs-site (pull_request) Successful in 1m19s
ci / rust-arm64 (pull_request) Successful in 1m27s
installer-smoke / smoke (arch) (pull_request) Successful in 1m27s
installer-smoke / smoke (fedora-44) (pull_request) Successful in 3m7s
installer-smoke / smoke (debian-13) (pull_request) Successful in 3m46s
ci / rust (pull_request) Successful in 6m26s
`punktfunk` only *Recommends* punktfunk-web (and punktfunk-scripting), so
`sudo dnf install punktfunk` installs the host with no console on any box where
weak deps are off — install_weak_deps=False, --setopt=install_weak_deps=0, or an
rpm-ostree layering that drops them. The user then follows step 4 and gets
"Unit punktfunk-web.service could not be found", with nothing saying why.

Name both subpackages in the install line at its single source
(data/platforms.json + the docs-site snapshot), which the guided installer and
the Fedora page quote verbatim, and drop the "the console comes with it" claim
from the README. Adds the symptom to Troubleshooting, including the other cause:
COPR has no punktfunk-web at all (no bun in its mock chroot).
2026-08-25 21:00:10 +02:00
6 changed files with 25 additions and 6 deletions
+1 -1
View File
@@ -102,7 +102,7 @@ installer (all-vendor: NVIDIA, AMD, Intel).
|--------|---------|-------|
| **Ubuntu 26.04+ / Debian 13+** (apt) | `sudo apt install punktfunk-host` *(after adding the repo)* | [Ubuntu](https://docs.punktfunk.unom.io/docs/ubuntu) · [Debian](https://docs.punktfunk.unom.io/docs/debian) · [packaging/debian](packaging/debian/README.md) |
| **Bazzite / Fedora Atomic** (systemd-sysext) | `curl -fsSLO https://git.unom.io/unom/punktfunk/raw/branch/main/packaging/bazzite/punktfunk-sysext.sh && sudo bash punktfunk-sysext.sh install` *(no layering, no reboot; rpm-ostree + bootc also supported)* | [Bazzite](https://docs.punktfunk.unom.io/docs/bazzite) |
| **Fedora** (dnf) | `sudo dnf install punktfunk` *(after adding the repo; the console comes with it)* | [Fedora](https://docs.punktfunk.unom.io/docs/fedora) · [packaging/rpm](packaging/rpm/README.md) |
| **Fedora** (dnf) | `sudo dnf install punktfunk punktfunk-web punktfunk-scripting` *(after adding the repo)* | [Fedora](https://docs.punktfunk.unom.io/docs/fedora) · [packaging/rpm](packaging/rpm/README.md) |
| **Arch / CachyOS** (pacman) | `sudo pacman -Syu punktfunk-host` *(binary repo — always a full `-Syu`)* | [Arch Linux](https://docs.punktfunk.unom.io/docs/arch) · [packaging/arch](packaging/arch/README.md) |
| **SteamOS / Steam Deck** (on-device build) | `bash ~/punktfunk/scripts/steamdeck/install.sh` *(after cloning this repo to `~/punktfunk`)* | [SteamOS (Host)](https://docs.punktfunk.unom.io/docs/steamos-host) |
| **Windows** (11 22H2+, x64) | `winget install unom.PunktfunkHost` *(after `winget source add -n punktfunk https://winget.punktfunk.unom.io -t Microsoft.Rest`)* · or the signed `setup.exe` from the package registry | [Windows Host](https://docs.punktfunk.unom.io/docs/windows-host) · [packaging/winget](packaging/winget/README.md) |
+1 -1
View File
@@ -117,7 +117,7 @@
"gpgkey=https://git.unom.io/api/packages/unom/rpm/repository.key",
" https://git.unom.io/api/packages/unom/generic/punktfunk-keys/1/RPM-GPG-KEY-punktfunk",
"REPO",
"sudo dnf install punktfunk"
"sudo dnf install punktfunk punktfunk-web punktfunk-scripting"
]
},
{
+3 -2
View File
@@ -29,8 +29,9 @@ For **Fedora 43 or newer** (Workstation or KDE). Bazzite and other Fedora Atomic
The RPM repo has one group per Fedora release: **`fedora-44`** on Fedora 44, **`bazzite`** on
Fedora 43 (it's a plain Fedora 43 build of the same package). `rpm -E %fedora` prints your number —
set `baseurl` to match, then install. The browser console, `punktfunk-web`, comes along
automatically:
set `baseurl` to match, then install. The install line names the browser console
(`punktfunk-web`) and the plugin runner (`punktfunk-scripting`) explicitly: they're *recommended*
deps of `punktfunk`, and a box with `install_weak_deps=False` would silently skip them.
<Install platform="fedora" />
+18
View File
@@ -187,6 +187,24 @@ ffmpeg -hide_banner -encoders | grep nvenc # expect hevc_nvenc / av1_nvenc / h
The same applies on a layered Bazzite / Fedora Atomic install; the sysext image carries its own.
## `systemctl --user status punktfunk-web`: unit not found
The web console is its own package, and the `punktfunk` RPM only *recommends* it
(`Recommends: punktfunk-web`) — a box with `install_weak_deps=False` in `/etc/dnf/dnf.conf`, a
`--setopt=install_weak_deps=0` install, or an `rpm-ostree` layering that drops weak deps gets the
host with no console and no unit to enable. Install it by name:
```sh
rpm -q punktfunk-web || sudo dnf install punktfunk-web punktfunk-scripting
systemctl --user enable --now punktfunk-web
journalctl --user -u punktfunk-web-init | sed -n 's/.*password generated: //p'
```
`No match for argument` instead means the repo you're on has no console: **COPR** builds host and
client only (its mock chroot has no `bun`). Use the RPM registry —
[Fedora](/docs/fedora#2-install-the-host), step 2. The same weak-dep miss happens on Debian/Ubuntu
after an `apt install --no-install-recommends`; the fix is `sudo apt install punktfunk-web`.
## pacman: error: could not register 'punktfunk' database (database already registered)
The repo block got appended to `/etc/pacman.conf` twice — the add line is an append, so running it
+1 -1
View File
@@ -117,7 +117,7 @@
"gpgkey=https://git.unom.io/api/packages/unom/rpm/repository.key",
" https://git.unom.io/api/packages/unom/generic/punktfunk-keys/1/RPM-GPG-KEY-punktfunk",
"REPO",
"sudo dnf install punktfunk"
"sudo dnf install punktfunk punktfunk-web punktfunk-scripting"
]
},
{
+1 -1
View File
@@ -283,7 +283,7 @@ REPO
CMD
)"
[ "$group" = fedora-44 ] || run "sudo sed -i 's|/rpm/fedora-44|/rpm/$group|' /etc/yum.repos.d/punktfunk.repo"
run 'sudo dnf install punktfunk'
run 'sudo dnf install punktfunk punktfunk-web punktfunk-scripting'
;;
sysext)
install_line='sudo bash punktfunk-sysext.sh install'