docs: restructure host setup by distro, configuration by compositor

Split the docs' single distro×desktop axis (ubuntu-gnome / ubuntu-kde / fedora-kde) into two, which deduplicates the shared mechanics and scales to distros that run several desktops (Arch): - Install the host — per distro/OS (ubuntu, fedora, arch, bazzite, steamos-host, windows-host): GPU driver + package + input group, then a canonical "Configure your desktop" funnel. - Configure your desktop — per compositor (kde, gnome, gamescope, sway): host.env, compositor quirks, the headless session, and starting the host. New shared web-console page (enable · login password · arm pairing) removes the console/password block that was copy-pasted across all seven host pages. Merged ubuntu-gnome + ubuntu-kde into ubuntu; renamed fedora-kde to fedora; kept bazzite and steamos-host as dedicated appliance guides (trimmed of duplication). Moved the KWin headless session, the GNOME EGL/lock traps, and the gamescope attach/managed model out of the distro pages onto their compositor pages. Fixed while restructuring: distro-specific paths on kde (kde-desktop-setup.sh is Fedora/Bazzite-only; the .deb ships host.env.kde under /usr/share/punktfunk-host), the interactive "start the host" step that was lost in the merge, sway over-claiming Hyprland, and a pre-existing broken anchor in how-it-works. Removal of the three old pages was captured by the preceding commit 8ebb614 (a concurrent commit swept up the staged git-rm); the net docs tree is correct. Fumadocs build + internal link/anchor check green. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-07-05 21:04:31 +00:00
parent 8ebb61400c
commit 69fcb6e0b1
21 changed files with 854 additions and 192 deletions
@@ -11,15 +11,19 @@ This is the shortest path to a working stream. Each step links to the details.

 ## 1. Set up the host

-On your Linux gaming machine (NVIDIA, AMD, or Intel GPU), follow the guide for your system:
+On your gaming machine (NVIDIA, AMD, or Intel GPU), follow the install guide for your system:

- [Ubuntu — GNOME](/docs/ubuntu-gnome)
- [Ubuntu — KDE Plasma](/docs/ubuntu-kde)
- [Fedora — KDE Plasma](/docs/fedora-kde)
- [Bazzite — gamescope / Steam](/docs/bazzite)
+- [Ubuntu / Debian](/docs/ubuntu)
+- [Fedora](/docs/fedora)
+- [Arch](/docs/arch)
+- [Bazzite](/docs/bazzite)
+- [SteamOS](/docs/steamos-host)
+- [Windows host](/docs/windows-host)

-Each one covers the GPU driver, the dependencies, and how to build and run the host. Check the
-[Requirements](/docs/requirements) first if you're not sure your machine is a fit.
+Each one covers the GPU driver, the dependencies, and how to install and run the host. After
+installing, configure for your desktop ([KDE](/docs/kde) / [GNOME](/docs/gnome) /
+[gamescope](/docs/gamescope) / [Sway](/docs/sway)). Check the [Requirements](/docs/requirements)
+first if you're not sure your machine is a fit.

 ## 2. Start the host

@@ -44,9 +48,9 @@ latency, or any Moonlight client:
  the list of hosts found on your network. Select it, and when prompted, **pair**.
 - **Anything with Moonlight:** add the host (it should be discovered automatically), then pair.

-To pair, the host needs to show a PIN. Arm pairing from the host's web console — the host displays a
-4-digit PIN, you type it into the client, and they trust each other from then on. Pairing is required
-by default. Full details: [Pairing & Trust](/docs/pairing).
+To pair, the host needs to show a PIN. [Arm pairing](/docs/web-console#arm-pairing) from the host's
+web console — the host displays a 4-digit PIN, you type it into the client, and they trust each other
+from then on. Pairing is required by default. Full details: [Pairing & Trust](/docs/pairing).

 ## 4. Stream