Files

T

enricobuehler 9e015304ee docs(dist): end-user install front door + serve/pairing/firewall accuracy fixes

Make the host docs match the real distribution path and the actual CLI. Reviewed by a
multi-agent pass (6 editors against one verified fact sheet + an accuracy reviewer); its
findings (a wrong client-Recommends claim, a native-concurrency overstatement) folded in.

- Install front door: new README "Install (host)" method-picker + docs-site/install.md
  (+ nav), routing each distro to its package registry; source build demoted to a fallback.
- Registry-first install: ubuntu-gnome/ubuntu-kde now lead with the apt registry (not a
  cargo build); bazzite leads with the Gitea RPM registry (was COPR/source). Source builds
  moved to an appendix.
- CLI accuracy: serve --native arms pairing from the web console (NOT --allow-pairing, which
  with --require-pairing/--max-concurrent is m3-host-only); --open disables mandatory pairing.
  host-cli/configuration/pairing/quickstart/troubleshooting corrected; mgmt API documented as
  always HTTPS+token. Native host serves one session at a time (extras queue) — not multi.
- Firewall: real ports documented (native UDP 9777 + the ephemeral data port caveat +
  GameStream ports) for Debian + Arch (ufw + nftables), not just Bazzite.
- Sync/accuracy: punktfunk-client (GTK4) presented as a shipping client (not "roadmap"),
  punktfunk-client-rs as the headless tool; host Recommends punktfunk-web only (not the
  client); COPR chroots f43/44; bootc header says Gitea registry not COPR.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-06-15 10:43:12 +00:00

README.md

docs(dist): end-user install front door + serve/pairing/firewall accuracy fixes

2026-06-15 10:43:12 +00:00

README.md

COPR build-from-SCM settings

COPR builds the RPM from this git repo (no manual SRPM upload). Configure the project once in the COPR web UI (or with copr-cli):

Project → New Build → SCM

Clone URL: https://git.unom.io/unom/punktfunk
Committish: main (or a release tag)
Subdirectory: (repo root)
Spec File: packaging/rpm/punktfunk.spec
Source build method: rpkg (or make_srpm)

Project settings

Chroots: fedora-43-x86_64, fedora-44-x86_64 (match your Bazzite Fedora base; rpm -E %fedora on the host tells you which). Add aarch64 if needed.
External repositories (so ffmpeg-devel resolves at build time): https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$releasever.noarch.rpm and the matching -free- repo.
Enable network during build (cargo fetches crates from crates.io) — COPR allows this by default.

copr-cli equivalent:

copr-cli create punktfunk --chroot fedora-44-x86_64 \
  --repo 'https://mirrors.rpmfusion.org/free/fedora/rpmfusion-free-release-$releasever.noarch.rpm' \
  --repo 'https://mirrors.rpmfusion.org/nonfree/fedora/rpmfusion-nonfree-release-$releasever.noarch.rpm'
copr-cli buildscm punktfunk \
  --clone-url https://git.unom.io/unom/punktfunk \
  --commit main --spec packaging/rpm/punktfunk.spec --method rpkg

Note: COPR caps build time/RAM; a full cargo build --release of the host (FFmpeg/PipeWire sys-crates + aws-lc-rs) is heavy but within the default COPR limits. If a chroot OOMs, lower parallelism with CARGO_BUILD_JOBS in the spec's %build.

The web console subpackage (`punktfunk-web`)

The spec can also build the management web console as a noarch punktfunk-web subpackage, but it's gated behind %bcond_with web and OFF by default — building the Nitro/Node SSR bundle needs bun, which COPR's mock chroot does not provide. So a stock COPR build produces only punktfunk

punktfunk-client.

Two ways to get the console:

Recommended: install it from the Gitea RPM registry (packaging/rpm/README.md, Option A), whose CI builder image has bun and builds --with web. (This is what bootc/Containerfile does.)
In COPR: add bun to the chroot (a custom mock config / external repo) and set the build option --with web on the project, then dnf install punktfunk-web.

README.md

COPR build-from-SCM settings

The web console subpackage (punktfunk-web)

The web console subpackage (`punktfunk-web`)