README: known issues (with symbols/error codes for searchability) + roadmap

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

OPERATIONS.md

@@ -114,6 +114,12 @@ high clocks. Change one thing at a time and re-check `sensors`.
   native GFN app cannot work on this GPU — it requires hardware video
   decode (error 0xC0F11312) that the BC-250 physically lacks. Streams
   decode on CPU: keep to 1080p.
+- **Fortnite: GeForce NOW is the only way** on this console (log into the
+  Epic account there — same skins/friends). Installing it via Lutris/
+  Heroic/Wine will never work: Epic deliberately doesn't allow Fortnite's
+  anti-cheat on Linux, and it also kicks home VMs. Not fixable; don't
+  waste the download. Other Epic games mostly work fine via Heroic —
+  check areweanticheatyet.com for any anti-cheat title.
 - Moonlight (installed): streams games from a home PC/server running
   Sunshine — pair it against the host's `https://<host>:47990` panel.
   Best-quality "cloud" gaming in the house: LAN latency, no subscription.

README.md

@@ -18,7 +18,7 @@ over-the-air from this Gitea's container registry.
 | Remote admin | `openssh-server` (enabled); **Sunshine** auto-serves the kid's session to Moonlight; `tailscaled` enabled. (RDP via `bc250-remote-setup` exists but is blocked by a mutter/GFX1013 crash) |
 | Console behavior | All suspend paths masked, no screen lock/dim, GNOME animations off — always on, always reachable |
 | Kid experience | Steam Big Picture autostarts for the `kid` account only |
-| Apps | First-boot flatpaks: ProtonUp-Qt, Heroic, RetroDECK, Prism Launcher (Minecraft) — Steam, Firefox, auto-updates already in the Bazzite base |
+| Apps | First-boot flatpaks: ProtonUp-Qt, Heroic, RetroDECK, Prism Launcher (Minecraft), Chromium, Moonlight — Steam, Firefox, auto-updates already in the Bazzite base |
 | Cloud gaming | GeForce NOW via a Chromium web-app shortcut (the native GFN app requires Vulkan video decode the BC-250 physically lacks — error 0xC0F11312). Moonlight client included for streaming from a home Sunshine host. Streams CPU-decode; keep to 1080p |
 | Fixes | `hhd.service` masked (crash-loops on BC-250) |
 | Docs | Parent manual baked at `/usr/share/doc/bc250-console/OPERATIONS.md` |
@@ -53,6 +53,52 @@ Big Picture autostart follows `CONSOLE_KID_USER` in `/etc/bc250-console.conf`.
 Modded BIOS (see [mothenjoyer69/bc250-documentation](https://github.com/mothenjoyer69/bc250-documentation)),
 then BIOS settings: 512 MB dynamic VRAM, IOMMU disabled, auto power-on.
 
+## Known issues (found the hard way on real hardware)
+
+All of these are worked around in this image; listed here for searchability
+and until fixed upstream.
+
+- **GNOME Remote Desktop (RDP/VNC) crashes the whole session** on this GPU:
+  `gnome-shell` SIGSEGV in `meta_cursor_renderer_get_cursor` via
+  `meta_screen_cast_monitor_stream_src_set_cursor_metadata` (mutter 50.3,
+  cyan-skillfish/GFX1013) the moment a client connects and requests
+  cursor-metadata frames. `MUTTER_DEBUG_DISABLE_HW_CURSORS=1` does **not**
+  help. *Workaround: Sunshine + Moonlight instead (baked). Upstream report
+  to GNOME/mutter: pending.*
+- **Sunshine crash-loops (SIGSEGV, exit 139) probing the Vulkan H.264
+  encoder** on a GPU with no video-encode hardware, instead of falling
+  through to the next encoder. *Workaround: `encoder = software` seeded
+  before first start (baked). Upstream report to LizardByte: pending.*
+- **GeForce NOW's native Linux app cannot run** — error `0xC0F11312`: the
+  client hard-requires Vulkan video-decode extensions and the BC-250's
+  silicon has no VCN block at all. Unfixable at the driver level.
+  *Workaround: GFN via Chromium web app (baked shortcut).*
+- **BlueBuild `default-flatpaks@v1` `notify: true` breaks on multi-user
+  systems**: the post-install notification runs `sudo -u` with all human
+  users newline-joined into one name, failing the whole install service.
+  *Workaround: `notify: false`. Upstream report: pending.*
+- **Bazzite's `bazzite-steam-bpm` shows "ERROR: code=0; This is
+  strange..."** at login when Steam lingers from a previous session: a
+  `waitpid` race on already-gone PIDs plus an `if !` clobbering `$?`.
+  *Workaround: this image ships its own quit-and-wait wrapper.*
+- Cosmetic: `amdgpu` logs a wall of `hpd(rx)`/`dal_irq` errors at every
+  boot on BC-250 — the display core probes IRQ sources this cut-down chip
+  lacks. Harmless; every BC-250 does this.
+
+## Roadmap / hoped-for work
+
+- File the four upstream bug reports above (coredumps and stack traces are
+  in hand).
+- In-home game streaming: Sunshine host VM (R730, RTX 3050 passthrough)
+  serving the baked Moonlight client — self-hosted "GeForce NOW" at LAN
+  latency. Fortnite stays on real GFN (Epic's anti-cheat policy).
+- Thermal soak validation and GPU governor ceiling tuning (see
+  OPERATIONS.md) once long gaming sessions accumulate.
+- Retry GNOME RDP after a fixed mutter ships; retry native GFN if NVIDIA
+  adds a software-decode fallback.
+- Explicit non-goal: the experimental 40-CU unlock — this console stays on
+  the stable 24-CU configuration.
+
 ## Credits
 
 Forked from

files/console/usr/share/doc/bc250-console/OPERATIONS.md

@@ -114,6 +114,12 @@ high clocks. Change one thing at a time and re-check `sensors`.
   native GFN app cannot work on this GPU — it requires hardware video
   decode (error 0xC0F11312) that the BC-250 physically lacks. Streams
   decode on CPU: keep to 1080p.
+- **Fortnite: GeForce NOW is the only way** on this console (log into the
+  Epic account there — same skins/friends). Installing it via Lutris/
+  Heroic/Wine will never work: Epic deliberately doesn't allow Fortnite's
+  anti-cheat on Linux, and it also kicks home VMs. Not fixable; don't
+  waste the download. Other Epic games mostly work fine via Heroic —
+  check areweanticheatyet.com for any anti-cheat title.
 - Moonlight (installed): streams games from a home PC/server running
   Sunshine — pair it against the host's `https://<host>:47990` panel.
   Best-quality "cloud" gaming in the house: LAN latency, no subscription.