Basic troubleshooting

Fix common Ryujinx Canary issues

Quick checks for startup problems, runtime prompts, security quarantine, Linux permissions, Steam Deck package choice, update regressions, and blocked source pages.

Common fixes

Start with the matching card, then return to downloads if the package choice was wrong.

Windows will not open

  • Confirm you selected a Windows package for your CPU architecture.
  • Extract the archive completely before starting the app.
  • Check whether required system runtimes and GPU drivers are current.

.NET or runtime prompt appears

  • Read the exact prompt and install only the runtime named by the app or Microsoft.
  • Restart the app after installing a runtime dependency.
  • Return to the same project-published build if a random installer page appears.

Windows Security quarantines a file

  • Stop and confirm the download came from the project release asset link.
  • Compare the file name with the release page before restoring anything.
  • If the source looks wrong, delete the file and download again from the trusted page.

SmartScreen or Gatekeeper appears

  • Treat this as a normal system safety prompt, not an automatic error.
  • Confirm the source page, file name, and platform before making a decision.
  • Do not blindly ignore safety prompts from files found on random mirror sites.

Linux AppImage will not run

  • Confirm the file is marked executable.
  • Confirm the package architecture matches your system.
  • Try launching from a terminal to see basic startup errors.

Wrong CPU architecture

  • Use Windows x64 for standard Windows PCs.
  • Use Linux x64 for most desktop Linux installs and Steam Deck.
  • Use ARM64 only when your operating system and release asset both say ARM64.

Steam Deck package choice

  • Start with the Linux or SteamOS package guidance.
  • Try Stable if the Canary package introduces a new issue.
  • This MVP guide keeps Steam Deck setup intentionally brief.

Graphics, sound, or input issue

  • Update GPU drivers before changing many app settings.
  • Try the alternate graphics API exposed by the app if one path fails.
  • Check input settings and test Desktop Mode on Steam Deck if a dialog cannot be clicked.

A newer update causes problems

  • Note the current version shown in the app or release file name.
  • Try a previously working version from the same trusted release source.
  • Read release notes or issue trackers for known regressions.

A release button will not open

  • Open the project release page directly from the External Sources section.
  • Check browser extensions, network filtering, or regional access issues.
  • Avoid substituting a random mirror just because a source is temporarily unavailable.
Back to downloads View releases

Last checked: