feature: game streamer (#9)

Author: lukepolo

.vitepress/config.mts

@@ -197,6 +197,15 @@ export default defineConfig({
             link: "/s3",
             items: [{ text: "Backblaze + Cloudflare", link: "/s3/backblaze" }],
           },
+          {
+            text: "Game Streaming",
+            link: "/game-streaming/",
+            items: [
+              { text: "NVIDIA", link: "/game-streaming/nvidia" },
+              { text: "AMD", link: "/game-streaming/amd" },
+              { text: "Intel", link: "/game-streaming/intel" },
+            ],
+          },
           {
             text: "Custom Kubernetes",
             link: "/custom-k8s",

advanced/game-streaming/amd.md

@@ -0,0 +1,13 @@
+# AMD GPU Setup
+
+::: warning Not yet supported
+Game streaming on AMD GPUs is not currently supported. The streamer pipeline encodes via NVENC (NVIDIA-specific) and the pod runtime relies on the NVIDIA Kubernetes runtime — neither has an AMD equivalent wired up yet.
+:::
+
+## Tracking issue
+
+We're tracking demand for AMD support here:
+
+**[5stackgg/5stack-panel#467 — AMD GPU support](https://github.com/5stackgg/5stack-panel/issues/467)**
+
+If you'd like to use AMD GPUs for game streaming, please **upvote and comment on the issue** with details about your hardware (model, driver, ROCm version, codec needs). The more concrete information we have, the easier it is to scope and prioritize.

advanced/game-streaming/index.md

@@ -0,0 +1,40 @@
+# Game Streaming
+
+5Stack can spectate live matches with [OpenHud](https://github.com/JohnTimmermann/OpenHud).
+
+## Requirements
+
+- At least one [game server node](/servers/game-server-nodes/) with a supported GPU and the relevant Kubernetes runtime installed (see GPU vendor pages below).
+- A Steam account dedicated to the streamer.
+
+## GPU Support
+
+| Vendor | Status |
+|---|---|
+| [NVIDIA](/advanced/game-streaming/nvidia) | Supported |
+| [AMD](/advanced/game-streaming/amd) | Not yet supported — [tracking issue #467](https://github.com/5stackgg/5stack-panel/issues/467) |
+| [Intel](/advanced/game-streaming/intel) | Not yet supported — [tracking issue #468](https://github.com/5stackgg/5stack-panel/issues/468) |
+
+::: warning Steam account must NOT have 2FA / Steam Guard
+The streamer logs into Steam non-interactively via `steamcmd` to download and run CS2. Steam Guard / Steam Mobile Authenticator will break this — every Job will get stuck waiting for a code that nobody can enter.
+
+**Use a dedicated Steam account with 2FA disabled.** Do not reuse a personal account.
+:::
+
+## Install
+
+Make sure the GPU drivers and Kubernetes runtime are set up on every node that will run the streamer — see [NVIDIA](/advanced/game-streaming/nvidia) for the full driver/toolkit steps.
+
+From your panel install directory, run:
+
+```bash
+./game-streamer.sh
+```
+
+The script will walk you through:
+
+1. **GPU vendor selection** — NVIDIA, AMD, or Intel. AMD and Intel exit early with a link to the tracking issue.
+2. **GPU node selection** — pick which cluster nodes have GPUs (multi-select). The script labels selected nodes with `nvidia-gpu=true` and `5stack-game-streamer=true`. Re-running the script with a different selection will add the labels to newly-selected nodes and remove them from previously-selected nodes.
+3. **Steam credentials** — username and password for the dedicated streamer account.
+
+Your selections are persisted to `.5stack-env.config` 

advanced/game-streaming/intel.md

@@ -0,0 +1,13 @@
+# Intel GPU Setup
+
+::: warning Not yet supported
+Game streaming on Intel GPUs is not currently supported. The streamer pipeline encodes via NVENC (NVIDIA-specific) and the pod runtime relies on the NVIDIA Kubernetes runtime — neither has an Intel equivalent wired up yet.
+:::
+
+## Tracking issue
+
+We're tracking demand for Intel support here:
+
+**[5stackgg/5stack-panel#468 — Intel GPU support](https://github.com/5stackgg/5stack-panel/issues/468)**
+
+If you'd like to use Intel GPUs (Arc discrete, or iGPU on recent Xeon / Core platforms) for game streaming, please **upvote and comment on the issue** with details about your hardware (model, driver, codec needs). The more concrete information we have, the easier it is to scope and prioritize.

advanced/game-streaming/nvidia.md

@@ -0,0 +1,34 @@
+# NVIDIA GPU Setup
+
+Game streaming on NVIDIA GPUs needs three things on every node that will run a streamer pod:
+
+1. The NVIDIA driver and CUDA userland.
+2. The NVIDIA Container Toolkit (so containerd can expose GPUs into pods).
+3. The Kubernetes `nvidia` overlay applied to your cluster (registers the device plugin so pods can request `nvidia.com/gpu`).
+
+## 1. Install drivers and the container toolkit
+
+On Ubuntu / Debian-based hosts:
+
+```bash
+sudo apt install -y \
+    nvidia-cuda-toolkit \
+    nvidia-container-toolkit \
+    nvidia-container-runtime \
+    cuda-drivers-fabricmanager-590 \
+    nvidia-headless-590-server-open \
+    nvidia-utils-590-server \
+    nvidia-driver-590-server-open
+```
+
+::: tip Driver version
+The `590` package suffix tracks the driver branch. Pick the branch that matches your GPU and CUDA version — `nvidia-driver-590-server-open` is a recent open-kernel branch that works for the streamer pipeline. If `apt` doesn't have it, you may need NVIDIA's `cuda-keyring` repo: see [NVIDIA's installation guide](https://docs.nvidia.com/datacenter/tesla/driver-installation-guide/).
+:::
+
+Reboot, then verify:
+
+```bash
+nvidia-smi
+```
+
+You should see your GPU(s) listed with the driver version. and you can conitnue to the [game streaming setup](/advanced/game-streaming#install).