diff --git a/.gitea/workflows/linux-client-screenshots.yml b/.gitea/workflows/linux-client-screenshots.yml
index fc42f3ca..9e28e6dc 100644
--- a/.gitea/workflows/linux-client-screenshots.yml
+++ b/.gitea/workflows/linux-client-screenshots.yml
@@ -111,3 +111,20 @@ jobs:
           name: punktfunk-linux-client-screenshots
           path: clients/linux/screenshots
           retention-days: 30
+
+      # The artifact above is browser-only (Gitea's API doesn't serve v3 artifacts), which
+      # blocked reusing these shots for the docs. Publish them to the generic package registry
+      # too — fixed version `ci`, delete-then-PUT so each run overwrites, anonymous GET on a
+      # public repo:
+      #   https://git.unom.io/api/packages/unom/generic/punktfunk-linux-client-screenshots/ci/<scene>.png
+      - name: Publish screenshots to the package registry
+        env:
+          TOKEN: ${{ secrets.REGISTRY_TOKEN }}
+        run: |
+          BASE="https://git.unom.io/api/packages/unom/generic/punktfunk-linux-client-screenshots/ci"
+          for f in clients/linux/screenshots/*.png; do
+            name=$(basename "$f")
+            curl -fsS -o /dev/null --user "enricobuehler:$TOKEN" -X DELETE "$BASE/$name" || true
+            curl -fsS -o /dev/null --user "enricobuehler:$TOKEN" --upload-file "$f" "$BASE/$name"
+            echo "published $BASE/$name"
+          done
diff --git a/docs-site/content/docs/quickstart.md b/docs-site/content/docs/quickstart.md
index 3ad4673e..2574c911 100644
--- a/docs-site/content/docs/quickstart.md
+++ b/docs-site/content/docs/quickstart.md
@@ -56,7 +56,11 @@ On the device you want to stream *to*, install the app — [Install a Client](/d
 has the link for every device (Mac, iPhone/iPad/Apple TV, Linux, Windows, Android, Steam Deck), and
 any Moonlight client works too once you [turn GameStream on](/docs/moonlight).
 
-Open the app: your host is already in the list. Select it and **connect**, then click **Approve**
+Open the app: your host is already in the list.
+
+![The client's host list: saved hosts with their pairing state, and unpaired hosts found on this network](/img/client-hosts.png)
+
+Select it and **connect**, then click **Approve**
 next to the device in the console's **Pairing** page — no PIN to type. (Prefer a PIN? **Pair a device**
 shows a 4-digit code to type into the client.) Pairing happens once; the device reconnects on its
 own from then on. Details: [Pairing & Trust](/docs/pairing).
diff --git a/docs-site/public/img/client-hosts.png b/docs-site/public/img/client-hosts.png
new file mode 100644
index 00000000..8dd9b2ee
Binary files /dev/null and b/docs-site/public/img/client-hosts.png differ