diff --git a/OPERATIONS.md b/OPERATIONS.md
index 4ccb1dd..8f54b40 100644
--- a/OPERATIONS.md
+++ b/OPERATIONS.md
@@ -19,6 +19,14 @@ One-time Moonlight pairing: browse to `https://<console-address>:47990`,
 create the Sunshine admin login, then enter the PIN Moonlight shows you in
 Sunshine's PIN tab. Sunshine starts automatically with the kid's session.
 
+Moonlight client settings that work well for admin sessions (verified):
+**1080p, 30 fps, windowed, "Optimize mouse for remote desktop instead of
+games"** — the mouse option is essential for a normal desktop pointer.
+If the console's IP changes (e.g. after a reinstall), delete the PC in
+Moonlight and re-pair with the new address — a stale host entry streams
+the wrong thing or nothing. Best fix: DHCP reservation in the router, or
+connect via the Tailscale name instead of the LAN IP.
+
 > Why not RDP? GNOME Remote Desktop crashes the session on this GPU
 > (mutter 50.x cursor-metadata screencast segfault on cyan-skillfish).
 > `bc250-remote-setup` still configures it if you want to retry after a
diff --git a/files/console/usr/share/doc/bc250-console/OPERATIONS.md b/files/console/usr/share/doc/bc250-console/OPERATIONS.md
index 4ccb1dd..8f54b40 100644
--- a/files/console/usr/share/doc/bc250-console/OPERATIONS.md
+++ b/files/console/usr/share/doc/bc250-console/OPERATIONS.md
@@ -19,6 +19,14 @@ One-time Moonlight pairing: browse to `https://<console-address>:47990`,
 create the Sunshine admin login, then enter the PIN Moonlight shows you in
 Sunshine's PIN tab. Sunshine starts automatically with the kid's session.
 
+Moonlight client settings that work well for admin sessions (verified):
+**1080p, 30 fps, windowed, "Optimize mouse for remote desktop instead of
+games"** — the mouse option is essential for a normal desktop pointer.
+If the console's IP changes (e.g. after a reinstall), delete the PC in
+Moonlight and re-pair with the new address — a stale host entry streams
+the wrong thing or nothing. Best fix: DHCP reservation in the router, or
+connect via the Tailscale name instead of the LAN IP.
+
 > Why not RDP? GNOME Remote Desktop crashes the session on this GPU
 > (mutter 50.x cursor-metadata screencast segfault on cyan-skillfish).
 > `bc250-remote-setup` still configures it if you want to retry after a