Troubleshoot
Quick checks for "won't open". Keys, firmware, and games: see the project wiki.
App will not start (Windows)
- Install the .NET Desktop Runtime named in the error (from Microsoft).
- Allow the app in Windows Security if quarantined.
- SmartScreen: More info → Run anyway (files from the official release page only).
Broke after an update
On Canary or Stable, open an older tag, re-download the same platform asset. Data paths: File → Open Ryujinx Folder when a build runs. Back up first.
Wrong asset
x64 and ARM64 differ. Re-download a matching asset. Install steps.
Linux / SteamOS
- AppImage will not run: chmod +x the file or enable "execute" in file properties.
- Steam Deck: use the x64 Linux build, not ARM64. See Linux → Steam Deck.
- Won't start after an old install: quit Ryujinx, rename
~/.config/Ryujinx, launch again (fresh config), then repeat first-time setup. - Forge / GitLab login or "page not working": the project may be under maintenance — check Ryubing, community notices, or try again later; prefer opening a release tag and Assets directly when the host allows.
- Game Mode (Deck) — Apply/OK not clickable: open the Steam keyboard (Steam + X), use Tab to focus Apply, then OK. For input, try Steam Controller under Options → Settings → Input (see also Setup → Steam Deck).
- If the on-screen keyboard stops appearing after sleep, a full restart of the device sometimes clears it.
Graphics / sound / input
In the app, try another graphics API (Vulkan vs OpenGL) and check Options. For full docs: