enricobuehler
58cb416abb
ci / web (push) Failing after 44s
ci / rust (push) Successful in 1m7s
apple / swift (push) Successful in 1m16s
ci / docs-site (push) Failing after 38s
docker / build-push (., web/Dockerfile, punktfunk-web) (push) Successful in 5s
deb / build-publish (push) Failing after 2m20s
docker / build-push (ci, ci/rust-ci.Dockerfile, punktfunk-rust-ci) (push) Successful in 4s
docker / build-push (docs-site, docs-site/Dockerfile, punktfunk-docs) (push) Successful in 4s
docker / build-push (ci, ci/fedora-rpm.Dockerfile, punktfunk-fedora-rpm) (push) Successful in 2m21s
docker / deploy-docs (push) Successful in 18s
rpm / build-publish (push) Successful in 3m57s
Mirrors the apt pipeline for Fedora Atomic / Bazzite. New `rpm` workflow builds the host RPM in a Fedora 43 builder image (ci/fedora-rpm.Dockerfile — matches Bazzite's libavcodec.so.61, with a self-contained 16-symbol libcuda link stub so no NVIDIA packages are needed in CI) and uploads to Gitea's public RPM registry (group "bazzite") on every main push (rolling 0.0.1-0.ciN.<sha>) and v* tag (clean X.Y.Z-1). Bazzite hosts then track it with `rpm-ostree upgrade`. - packaging/rpm/build-rpm.sh: git-archive tarball + rpmbuild (--nodeps, since the toolchain is rustup + dnf, not RPMs); copies to dist/, asserts no cuda/nvidia leak. - punktfunk.spec: overridable pf_version/pf_release for CI snapshots; exclude libcuda.so from auto-Requires (NVENC/EGL come from the driver, out of band) — same NVIDIA filter as the .deb; fix a bogus changelog weekday. - docker.yml builds+pushes the new fedora-rpm image; packaging README + rpm/README document the rpm-ostree install/update path (recommended option). Builder image seeded to the registry so rpm.yml's first run finds it. RPM build + clean-Requires verified locally in the image (libavcodec.so.61 / libavutil.so.59, no cuda). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
103 lines
4.8 KiB
Markdown
103 lines
4.8 KiB
Markdown
# Packaging punktfunk for Fedora / Bazzite
|
|
|
|
The punktfunk host is Linux-only and links system FFmpeg (NVENC), PipeWire, Opus and
|
|
the NVIDIA driver. This directory packages it for the **Fedora Atomic / Bazzite** world
|
|
(rpm-ostree + bootc), where most of those deps are already present.
|
|
|
|
> 👉 **Ubuntu/Debian hosts** install via `apt` from Gitea's package registry — see
|
|
> [`debian/README.md`](debian/README.md) (`apt update && apt upgrade` for new builds).
|
|
|
|
> 👉 **End-to-end Bazzite setup walkthrough** (install → udev/group → `host.env` → service →
|
|
> firewall → verify → troubleshooting): [`bazzite/README.md`](bazzite/README.md). This file is the
|
|
> higher-level packaging rationale.
|
|
|
|
```
|
|
packaging/
|
|
rpm/punktfunk.spec # the RPM (builds punktfunk-host from source with cargo)
|
|
bazzite/host.env # gamescope-default config for a Bazzite appliance
|
|
bazzite/README.md # step-by-step Bazzite setup guide
|
|
bootc/Containerfile # bake punktfunk into a Bazzite-based atomic image
|
|
copr/ # COPR build-from-SCM settings
|
|
```
|
|
|
|
## What's needed beyond base Fedora
|
|
|
|
| Dependency | Where it comes from |
|
|
|---|---|
|
|
| `ffmpeg-libs` with **NVENC** | **RPM Fusion nonfree** (`ffmpeg`, not `ffmpeg-free`) |
|
|
| NVIDIA driver (`libnvidia-encode`, `libEGL_nvidia`) | Bazzite **-nvidia** images ship it; plain Fedora: `akmod-nvidia` + `xorg-x11-drv-nvidia-cuda` |
|
|
| gamescope, PipeWire, wireplumber | **Bazzite ships these**; plain Fedora: `dnf install gamescope pipewire wireplumber` |
|
|
| `opus`, `libei` | Fedora base / updates |
|
|
|
|
On **Bazzite** the only genuinely new runtime bits are `ffmpeg-libs` (RPM Fusion) + `opus` +
|
|
`libei` — the rest of the stack is already there. The default backend is **gamescope**
|
|
(`packaging/bazzite/host.env`), which the host spawns headless per session — no desktop login.
|
|
|
|
## Option A — Gitea RPM registry (recommended; per-host, `rpm-ostree`)
|
|
|
|
The host's RPM is published to **unom's self-hosted Gitea RPM registry** (CI builds it on every
|
|
push), mirroring the [Debian/apt](debian/README.md) setup. Add one repo file, install, and track
|
|
updates with `rpm-ostree upgrade` — no COPR account needed. Full guide: [`rpm/README.md`](rpm/README.md).
|
|
|
|
```sh
|
|
curl -fsSL https://git.unom.io/api/packages/unom/rpm/bazzite.repo \
|
|
| sudo tee /etc/yum.repos.d/punktfunk.repo
|
|
rpm-ostree install punktfunk && systemctl reboot
|
|
# updates: rpm-ostree upgrade && systemctl reboot
|
|
```
|
|
|
|
## Option B — COPR (per-host, `rpm-ostree install`)
|
|
|
|
1. Create a COPR project, enable **build-from-SCM** pointing at this repo, spec path
|
|
`packaging/rpm/punktfunk.spec` (see `copr/README.md`). Under *External Repositories* add
|
|
RPM Fusion nonfree so `ffmpeg-devel` resolves at build time.
|
|
2. On the Bazzite host:
|
|
```sh
|
|
# RPM Fusion (for the NVENC ffmpeg) — usually already enabled on Bazzite
|
|
rpm-ostree install \
|
|
https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$(rpm -E %fedora).noarch.rpm \
|
|
https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$(rpm -E %fedora).noarch.rpm
|
|
# enable the COPR + install punktfunk
|
|
sudo wget -O /etc/yum.repos.d/_copr_punktfunk.repo \
|
|
https://copr.fedorainfracloud.org/coprs/enricobuehler/punktfunk/repo/fedora-$(rpm -E %fedora)/
|
|
rpm-ostree install punktfunk
|
|
systemctl reboot
|
|
```
|
|
|
|
## Option B — bootc (image-based, atomic)
|
|
|
|
Layer punktfunk into a Bazzite image once, then rebase any number of hosts onto it — no
|
|
per-host drift. See `bootc/Containerfile`:
|
|
```sh
|
|
podman build -t ghcr.io/<you>/bazzite-punktfunk -f packaging/bootc/Containerfile .
|
|
podman push ghcr.io/<you>/bazzite-punktfunk
|
|
# on the target:
|
|
sudo bootc switch ghcr.io/<you>/bazzite-punktfunk && systemctl reboot
|
|
```
|
|
|
|
## First-run setup (either option)
|
|
|
|
```sh
|
|
ujust add-user-to-input-group # virtual gamepads need /dev/uinput (then re-login).
|
|
# On Bazzite use ujust, NOT `usermod -aG input` (atomic OS — it won't stick).
|
|
mkdir -p ~/.config/punktfunk
|
|
cp /usr/share/punktfunk/host.env.bazzite ~/.config/punktfunk/host.env # edit (gamescope app, etc.)
|
|
systemctl --user enable --now punktfunk-host
|
|
```
|
|
|
|
Pair a stock Moonlight client (mDNS-discovered), or connect the native punktfunk/1 client.
|
|
|
|
## Why not Flatpak?
|
|
|
|
The host needs unsandboxed access the zero-copy NVENC path, `/dev/uinput`, the PipeWire
|
|
graph and the compositor's privileged protocols — a Flatpak sandbox fights all of these.
|
|
An RPM (or the bootc layer) installs into the host system where those just work.
|
|
|
|
## Building the SRPM/RPM locally (Fedora only)
|
|
|
|
```sh
|
|
git archive --format=tar.gz --prefix=punktfunk-0.0.1/ -o ~/rpmbuild/SOURCES/punktfunk-0.0.1.tar.gz HEAD
|
|
rpmbuild -ba packaging/rpm/punktfunk.spec # needs the BuildRequires from the spec
|
|
```
|
|
(Not buildable on Debian/Ubuntu — use a Fedora toolbox/container or COPR.)
|