Ryujinx won't start — do I need .NET?

On Windows, install the .NET Desktop Runtime version shown in the error message from Microsoft, then relaunch Ryujinx.

Ryujinx on Steam Deck — which build?

Always download the Linux x64 AppImage or tar.gz — not ARM64. Set up keys and firmware in Desktop Mode first.

Black screen or crash in games?

Try switching the graphics backend between Vulkan and OpenGL in Options → Settings → Graphics. Update GPU drivers and clear the shader cache if needed.

Canary vs Stable — which should I use?

Stable is better for first-time users; Canary gets updates faster but may break. You can roll back from the release page.

Troubleshoot

Quick checks for "won't open". Keys, firmware, and games: see the official docsfirst, then Forge wiki for edge cases.

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).

Download .NET (Microsoft)

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.

Pick a build and roll back

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:

Official docs Forge wiki

Official downloads

Latest Canary Latest Stable

All Canary releases All Stable releases

Common questions

Ryujinx won't start — do I need .NET?: On Windows, install the .NET Desktop Runtime version shown in the error message from Microsoft, then relaunch Ryujinx.
Ryujinx on Steam Deck — which build?: Always download the Linux x64 AppImage or tar.gz — not ARM64. Set up keys and firmware in Desktop Mode first. Steam Deck guide.
Black screen or crash in games?: Try switching the graphics backend between Vulkan and OpenGL in Options → Settings → Graphics. Update GPU drivers and clear the shader cache if needed.
Canary vs Stable — which should I use?: Stable is better for first-time users; Canary gets updates faster but may break. You can roll back from the release page. Canary vs Stable.