From 6ca7e4a7ec47c48169f5890270ab8f2bf1001880 Mon Sep 17 00:00:00 2001 From: enricobuehler Date: Fri, 28 Aug 2026 22:11:10 +0200 Subject: [PATCH] docs: the one-command install stops hiding on the hub page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The guided installer covers apt, dnf, pacman and sysext boxes, but only the install hub mentioned it — a reader who lands on /docs/ubuntu from a search never learns the whole page has a one-liner. Put the same block above step 1 on every page the script actually detects, and leave NixOS, SteamOS and Windows alone: the script refuses those and points at their pages. Also list Omarchy on the hub cards and in the quickstart table. It was added to the sidebar with #428 but never to the two pages that route people there. --- docs-site/content/docs/arch.mdx | 8 ++++++++ docs-site/content/docs/bazzite.mdx | 8 ++++++++ docs-site/content/docs/debian.mdx | 8 ++++++++ docs-site/content/docs/fedora.mdx | 8 ++++++++ docs-site/content/docs/install.mdx | 1 + docs-site/content/docs/omarchy.mdx | 8 ++++++++ docs-site/content/docs/quickstart.md | 2 +- docs-site/content/docs/ubuntu.mdx | 8 ++++++++ 8 files changed, 50 insertions(+), 1 deletion(-) diff --git a/docs-site/content/docs/arch.mdx b/docs-site/content/docs/arch.mdx index 449d8126..b83c5bbf 100644 --- a/docs-site/content/docs/arch.mdx +++ b/docs-site/content/docs/arch.mdx @@ -7,6 +7,14 @@ For **Arch Linux** and Arch-based distros (CachyOS, EndeavourOS, …). The host binary repo and updates with `pacman -Syu` like everything else. SteamOS is different — it has [its own page](/docs/steamos-host). +**One command instead?** The [guided installer](/docs/install#guided-install-preview) (preview) does +everything on this page — it detects the distro, installs the host, joins the groups, opens the +firewall and starts it: + + + +The steps below are the same thing by hand, and stay the documented path. + ## 1. GPU driver - **NVIDIA:** `sudo pacman -S --needed nvidia-utils` (NVENC and the zero-copy path; Arch's `ffmpeg` diff --git a/docs-site/content/docs/bazzite.mdx b/docs-site/content/docs/bazzite.mdx index 9309ec8a..74652c20 100644 --- a/docs-site/content/docs/bazzite.mdx +++ b/docs-site/content/docs/bazzite.mdx @@ -8,6 +8,14 @@ Plasma — so this is the most appliance-like setup. One host streams **both** o Steam **Gaming Mode** and the **KDE desktop**, and follows the box when you switch, even mid-stream. Nothing in the config picks a mode. +**One command instead?** The [guided installer](/docs/install#guided-install-preview) (preview) does +everything on this page — it detects the distro, installs the host, joins the groups, opens the +firewall and starts it: + + + +The steps below are the same thing by hand, and stay the documented path. + ## 1. Install the host The host installs as a **systemd system extension** — it overlays `/usr` from diff --git a/docs-site/content/docs/debian.mdx b/docs-site/content/docs/debian.mdx index 8cc2b7e0..bb1c4aa0 100644 --- a/docs-site/content/docs/debian.mdx +++ b/docs-site/content/docs/debian.mdx @@ -10,6 +10,14 @@ package needs 2.39) — [build from source](/docs/build-from-source) there, or u > KDE (KWin 6.3) is below the floor, and a Cinnamon desktop (Linux Mint, LMDE) can only host through > gamescope. [What each desktop can do, and what Linux Mint 22 can't](/docs/requirements#cinnamon-linux-mint-and-lmde). +**One command instead?** The [guided installer](/docs/install#guided-install-preview) (preview) does +everything on this page — it detects the distro, installs the host, joins the groups, opens the +firewall and starts it: + + + +The steps below are the same thing by hand, and stay the documented path. + ## 1. GPU driver - **NVIDIA:** the driver lives in `non-free`, which a default install doesn't enable. Enable it, diff --git a/docs-site/content/docs/fedora.mdx b/docs-site/content/docs/fedora.mdx index de007d2b..e5865f75 100644 --- a/docs-site/content/docs/fedora.mdx +++ b/docs-site/content/docs/fedora.mdx @@ -6,6 +6,14 @@ description: Install the Punktfunk host on Fedora 43 or newer from the RPM repo For **Fedora 43 or newer** (Workstation or KDE). Bazzite and other Fedora Atomic spins have [their own page](/docs/bazzite). +**One command instead?** The [guided installer](/docs/install#guided-install-preview) (preview) does +everything on this page — it detects the distro, installs the host, joins the groups, opens the +firewall and starts it: + + + +The steps below are the same thing by hand, and stay the documented path. + ## 1. GPU driver - **NVIDIA:** the driver and an NVENC-capable FFmpeg both come from **RPM Fusion** — Fedora's own diff --git a/docs-site/content/docs/install.mdx b/docs-site/content/docs/install.mdx index cb598cb2..763c79eb 100644 --- a/docs-site/content/docs/install.mdx +++ b/docs-site/content/docs/install.mdx @@ -13,6 +13,7 @@ repositories on Linux and from a signed installer on Windows — pick your syste + diff --git a/docs-site/content/docs/omarchy.mdx b/docs-site/content/docs/omarchy.mdx index dec02164..4cabb9aa 100644 --- a/docs-site/content/docs/omarchy.mdx +++ b/docs-site/content/docs/omarchy.mdx @@ -14,6 +14,14 @@ Omarchy already ships Sunshine as an installable service and preinstalls moonlig box](#sunshine-on-the-same-box) before you turn anything on. +**One command instead?** The [guided installer](/docs/install#guided-install-preview) (preview) does +everything on this page — it detects the distro, installs the host, joins the groups, opens the +firewall and starts it: + + + +The steps below are the same thing by hand, and stay the documented path. + ## 1. GPU driver Same as Arch: diff --git a/docs-site/content/docs/quickstart.md b/docs-site/content/docs/quickstart.md index 2574c911..0ab3dd65 100644 --- a/docs-site/content/docs/quickstart.md +++ b/docs-site/content/docs/quickstart.md @@ -14,7 +14,7 @@ install command, the group to join, and nothing else: | Linux | Windows | |---|---| -| [Ubuntu](/docs/ubuntu) · [Debian](/docs/debian) · [Fedora](/docs/fedora) · [Arch / CachyOS](/docs/arch) · [Bazzite](/docs/bazzite) · [SteamOS](/docs/steamos-host) · [NixOS](/docs/nixos) | [Windows 11](/docs/windows-host) | +| [Ubuntu](/docs/ubuntu) · [Debian](/docs/debian) · [Fedora](/docs/fedora) · [Arch / CachyOS](/docs/arch) · [Omarchy](/docs/omarchy) · [Bazzite](/docs/bazzite) · [SteamOS](/docs/steamos-host) · [NixOS](/docs/nixos) | [Windows 11](/docs/windows-host) | Not sure your machine qualifies? [Requirements](/docs/requirements) is the checklist. diff --git a/docs-site/content/docs/ubuntu.mdx b/docs-site/content/docs/ubuntu.mdx index bd6b5a0f..34e67599 100644 --- a/docs-site/content/docs/ubuntu.mdx +++ b/docs-site/content/docs/ubuntu.mdx @@ -9,6 +9,14 @@ For **Ubuntu 26.04 or newer**, Desktop or Server, GNOME or KDE. > virtual display, and there is no gamescope for it. Use 26.04. > [Why, in detail](/docs/requirements#the-floor-for-a-working-host). +**One command instead?** The [guided installer](/docs/install#guided-install-preview) (preview) does +everything on this page — it detects the distro, installs the host, joins the groups, opens the +firewall and starts it: + + + +The steps below are the same thing by hand, and stay the documented path. + ## 1. GPU driver - **NVIDIA:** install the recommended driver and its GL/EGL userspace (Wayland needs it), then -- 2.54.0