Troubleshoot

This error is specific to the old GTK UI. As of 1.1.1217, Avalonia has become the default, so please redownload Ryujinx if possible. If you're on an old, unsupported version:

Some emulator files are missing. Redownload Ryujinx, make sure it’s extracted properly and don’t put it on the desktop or the root of a drive, as those are protected folders. Third party antivirus software can also randomly delete these files, so if you have one, make exceptions for Ryujinx or uninstall the antivirus.

Similar to the above, Ryujinx is most likely in a protected folder. Move it somewhere else.

Ensure Ryujinx is not on the desktop or a protected folder and that you don't have any third party antivirus software. This issue has also been reported to have been caused by "defender omega" controllers, so disconnect it if you have one.

If you have a system consisting of an AMD Ryzen CPU with an AMD Radeon iGPU (4600H, 4800H, 5600H etc) and an Nvidia dGPU, you need to update BOTH graphics card drivers from their respective websites. Not just the dedicated Nvidia one, and not just from Windows update.

https://www.amd.com/en/support

https://www.nvidia.com/download/index.aspx

If your hardware doesn’t match the above, it’s possible your GPU drivers are simply out of date. In the case that they aren’t, your GPU might not meet the minimum requirements to run Ryujinx, for example any Intel iGPUs 5th gen or older.

Same as above.

Similar to the issue above, the emulator cannot detect a graphics card with Vulkan support. Check that your GPU drivers are on the latest possible version, and if they are, then unfortunately your GPU doesn’t meet minimum requirements.

Similar to the issue above, the emulator cannot detect a graphics card with Vulkan support. Check that your GPU drivers are on the latest possible version, and if they are, then unfortunately your GPU doesn’t meet minimum requirements.

Similar to the issue above, the emulator cannot detect a graphics card with Vulkan support. Check that your GPU drivers are on the latest possible version, and if they are, then unfortunately your GPU doesn’t meet minimum requirements.

This error is specific to the old GTK UI. As of 1.1.1217, Avalonia has become the default, so please redownload or update Ryujinx if possible. If you're on an old, unsupported version: If the error looks like this, click the game once then press Enter or use the Avalonia UI.

Your game file, update file or both are corrupted/invalid, you need to dump them again and ensure nothing goes wrong in the process.

• If removing the update works, it's the update file that is corrupted.
• If the error still occurs, it's the game file that is corrupted.

Similar to the above error, the file you’re trying to load is not a supported file type or may be corrupt.

You might be running an update file instead of a game file. See here for how to properly update a game. Another possible cause is Ryujinx might be forbidden from accessing the save folder for this game. This can be either due to a permission issue, for instance, from being placed on the desktop, the root of a drive or any kind of protected folder; or due to an antivirus not allowing the files to be accessed by the emulator.

Your firmware is too old to run the game you’re trying to run, and it tried to use files that don’t exist in such an old version. Update your keys and firmware.

The file you're trying to install as a firmware does not contain actual firmware. See the firmware dumping guide for how to dump yours.

The error itself tells you. Firmware and keys go hand in hand; if you update your firmware, you need to update your keys too.

Similar to the above; redump and update your keys.

Similar to the above; redump and update your keys.

Similar to the above; redump and update your keys.

Similar to the above; redump and update your keys.

Go to C:\Users\yourname\AppData\Roaming\Ryujinx\bis\system\Contents\registered (or portable\bis\system\Contents\registered if on a portable install) and delete the contents of the “registered” folder, then reinstall your firmware. If that doesn't work, redump/update your keys.

If you get this error but the below strings mention PTC, it means your PPTC is corrupted, in which case right click the game on the games list > Cache Management > Queue PPTC Rebuild.

When dumping your game, enable “Remove console specific data”, “Generate ticket-less dump” and “Change NPDM RSA key/sig in Program NCA” in nxdumptool.

You're trying to load an update file instead of a game file. See the setup guide for how to properly update your games.

First, make sure that the game you are trying to run is actually supported and that your graphics card is capable of running it.

If you have an Nvidia GPU, go to the Nvidia control panel and click Restore to set it to default settings.

If you have an AMD or Intel GPU, update your GPU drivers and use the Vulkan graphics backend.

If you only have an Intel iGPU, make sure it's on a 6th-gen CPU or newer. Older Intel iGPUs do not support the necessary features to run Ryujinx.

If the problem persists, make sure that any external application that could affect rendering is disabled. This includes software which puts an overlay on top of the emulator display window, like the MSI Afterburner overlay or Twitch Studio.

Restore your Nvidia control panel global settings to defaults

Disable sharpening under global graphics in the Radeon control panel.

Close the console window, it will also close the other one. If you’ve hidden the console, you’ll need to use the task manager to terminate the Ryujinx process. As of 1.1.848, this should happen much less frequently.

This means your VRAM was exhausted. Check that your resolution scaling isn’t too high; 4x is overkill for virtually every setup.

If you’re playing Astral Chain, Bayonetta 3, Fire Emblem Engage, Metroid Prime Remastered, Super Mario Bros. Wonder or The Legend of Zelda: Tears of the Kingdom, you might need to enable texture recompression in graphics settings. This is because these games use ASTC textures, which are supported natively without needing to be decompressed on the Switch, but when decompressed on PC can become massive and take up a lot of VRAM.

If you’re playing other games and your resolution is on native, it might be an issue with emulating that particular game.

This is a generic Vulkan crash. There’s hardly any information that can be gleaned from it, and the solutions vary wildly from case to case, but most of the time it’s not something users can fix or workaround.

On Nvidia, some device loss crashes were introduced in driver version 527.37 (not just in emulated games; native PC games too) and, at time of writing, it seems drivers newer than this still have some problems. If you are on newer Nvidia drivers and can’t find any mention of these crashes in the compatibility list for your game, it might be worth downgrading the driver version.

On AMD and Intel GPUs, a bigger amount of games have this issue. If updating to the latest drivers doesn’t fix it, your best bet will be Linux and Mesa drivers.

This means the game itself crashed, and not the emulator. The cause could be a million different things; however the key for troubleshooting this is not in the error itself, but rather what comes before it.

As shown in this example, right before the “guest stack trace”, there will be a short error with a code at the end. There can be many of these as well, but we’ll cover the most common.

• ResultFsPermissionDenied (2002-6400) here usually means Ryujinx has been denied access to the save folder for this game. Most of the time it’s solved if you delete the save folder: Right click the game > Open User Save Directory. Backup the contents if you care about the save. Go up 2 levels and delete the selected folder. Run the game again.

  • If this doesn’t fix it, check that Ryujinx isn’t on a protected folder (such as the desktop or the root of a drive) and that a third party antivirus (if you have one) isn’t blocking Ryujinx from using the save folder. If all else fails, make a portable install and bring over your caches and saves from the previous install.

• ResultFsTargetNotFound (2002-1002) might have the same causes and solutions as those described above.

• ResultKvdbInvalidKeyValue (2020-0005), also similar to the 2 above errors, means the savedata index for the game isn’t found, so the savedata is corrupted. Try backing up and then deleting the game's savedata folders. If this doesn't solve it, backup your whole Ryujinx data folder (C:\Users\yourname\AppData\Roaming\Ryujinx, or the portable folder if you've made a portable install) and then delete it. Then restore the subfolders (caches, save files) you'd like to keep.

• ResultFsOutOfRange (2002-3005) usually indicates a bad dump (corrupt game files). If FS integrity checks is disabled and you are getting this error, enable it, run the game again and check if you now get a hash error as described here.

• ResultErrApplicationAborted (2162-0001) is as generic as it gets. Check your game’s compatibility list entry or the game-specific troubleshooting entry in this page if you get this.

This is another generic error. It also doesn’t normally show on logs, only on the console when crashing. A possible cause is Ryujinx being in a protected folder or blocked by a third party antivirus. If this is not the case, check the compatibility page for your game.

If you're getting this error when running a game on Vulkan and the below strings mention SDL2, you need to uninstall Gshade or stop it from trying to hook onto Ryujinx. Similarly, if Ryujinx won't open and the below strings also mention SDL2, close Medal.

If you're getting this error on a Rog Ally, go to Add or remove programs on Windows and uninstall the "OpenCL, OpenGL, and Vulkan Compatibility Pack".

Invalid memory access errors, especially ones with the 0x0000000000000000 address, are usually caused by mod or cheat conflicts. Check that any given 2 (or more) mods or cheats you’re using don’t modify the same game files, and remove them if they do. This error can also be caused by poorly-made mods that don’t work on Nintendo Switch hardware.

Be aware that disabled cheats are still loaded into memory, so that they can be enabled while the game is running; if you are getting this crash and only have cheats but no mods, the issue is likely a conflict among the cheats, even if they’re disabled.

Disable Ryujinx vsync and cap the framerate externally via your GPU driver settings or RivaTuner Statistics Server. Note that this won’t work for all games; Super Smash Bros. Ultimate, for instance, speeds up even if you cap the framerate externally, as it relies on the vsync signal to determine game speed.

As of 1.1.739, frametimes are considerably smoother.

On the Nvidia control panel, head to Vulkan/OpenGL present method and select Prefer layered on DXGI Swapchain to enable GSync on a GSync-compatible monitor.

Open Ryujinx settings before running a game.

Shutdown Steam or disable the gamepad configurations you may have active on Steam.

Do not use Betterjoy or DS4Windows, they work with Ryujinx natively and external software may cause issues.

Make sure Ryujinx is allowed on your firewall. If it still occurs, disable P2P in multiplayer settings.

Both Ryujinx and the CFW Switch must be on the same network, timezone setting and game version. Check that Ryujinx is not being blocked by the firewall or a third party antivirus, that you're using a custom user profile on Ryujinx, that you’ve actually selected ldn_mitm in Ryujinx’s multiplayer settings, that you've enabled ldn_mitm on your Switch console and that no passphrase is being used. Try several times as well, since it doesn’t always work on the first attempt.

If the save is from a newer game version, trying to use it on an older update may cause the game to read it as corrupted. In this case simply exit the emulation and update the game.

If your PC shuts down unexpectedly (blue screen, power outage) while the game is running, the save file might also get corrupted. This is due to Windows keeping the file open at all times, and not just when the game is being saved. As a general rule of thumb, we recommend making frequent backups of your save files, in case something like this happens.

The wording is a bit unclear. The error refers to the CPU thread that processes the emulated GPU being too slow, and not your GPU being too slow. This error mostly pops up during shader compilation, which is normal and you shouldn't worry about.

However, if you're getting it even with shaders cached, that may mean your CPU is a tad slower than what is recommended to run Ryujinx properly.

These are both errors that don’t actually affect how any game runs and are safe to ignore.

Change your audio backend to SDL2 or OpenAL. SoundIO can cause this crash in certain situations.

If you are on Windows 11, Windows Command Line needs to be set to Windows Console Host instead of Windows Terminal for it to work.

Redownload the emulator and do not update while a game is running or settings are open. Do not extract it to a protected folder such as the desktop. Make exceptions for or uninstall any third party antivirus you might be using.

Simply head to the website, download the latest version and delete the Ryujinx folder that failed to update, with care not to delete your portable folder if you have one. This may happen if you update while a game is running or while emulator settings are open, if you have a third party antivirus falsely flagging Ryujinx upon updating or if you have Ryujinx on a protected folder, such as the desktop or the root of a drive.

Ryujinx does not support connecting to Nintendo Switch Online (NSO). Any options in a game that prompt you to connect to the internet will almost assuredly try to connect to Nintendo servers, which will not work.

If you are trying to play multiplayer with other Ryujinx users, you will want local wireless/local play/play locally, which despite the name will work over the internet. If you are trying to play with Nintendo Switch users, you want LAN mode in games that support it, or ldn_mitm which will allow playing with consoles via LDN, though only if they’re hacked.

Pause and unpause emulation (F5 by default). You may also try changing your audio backend to OpenAL if you're on SDL2.

Uninstall Avast. Ryujinx is safe as long as you downloaded it from our the new official website.

Similar to the issue above, the emulator cannot detect a graphics card with Vulkan support. Check that your GPU drivers are on the latest possible version, and if they are, then unfortunately your GPU doesn’t meet minimum requirements.