Ryujinx is a Nintendo Switch emulator for Windows, macOS, Linux, and Steam Deck. To run Switch games, it requires two files you must obtain from your own Nintendo Switch hardware: a prod.keys file (cryptographic decryption keys) and a firmware package (the Switch operating system). Without both, Ryujinx cannot decrypt or run any game file.
This guide explains what Ryujinx prod keys and firmware are, what each file does inside the emulator, exactly where to place them on every supported platform, how to install firmware through the Ryujinx interface, how to verify your setup is working, and how to fix the most common errors including the RYU-0001 keys not found error.
Legal note: Ryujinx prod.keys must be legally dumped from a Nintendo Switch console you own. This guide explains the technical function and installation of these files — it does not distribute or link to key or firmware files.
What Is Ryujinx?
Ryujinx is an open-source, high-accuracy Nintendo Switch emulator written in C# and maintained on GitHub. It is one of the most actively developed Switch emulators and is known for prioritizing game accuracy over raw performance — meaning games are more likely to run correctly in Ryujinx, though they may require more CPU/GPU power than in performance-focused emulators.
Ryujinx supports Windows, Linux, macOS, and Steam Deck (via the Linux build). It also has a Canary build — an unstable but more frequently updated version that includes experimental features not yet merged into the main release. Both the main and Canary builds use the same prod.keys file and firmware.
Ryubing is an alternative fork of Ryujinx that maintains compatibility with the same prod.keys and firmware format — the setup process for Ryubing is identical to the main Ryujinx build.
System Requirements for Ryujinx
PC minimum requirements
| Component | Minimum Specification |
| Operating System | Windows 10 64-bit / Ubuntu 22.04+ / macOS 12+ |
| CPU | Intel Core i5-8400 or AMD Ryzen 5 2600 (4-core+) |
| RAM | 8 GB (16 GB recommended for demanding titles) |
| GPU | NVIDIA GTX 1060 / AMD RX 580 — OpenGL 4.5 or Vulkan support required |
| Storage | SSD strongly recommended; NVMe for shader compilation speed |
| Graphics driver | NVIDIA 471.41+; AMD 21.9.1+; Intel 30.0+ (Vulkan 1.1+) |
PC recommended requirements
| Component | Recommended Specification |
| CPU | Intel Core i7-10700K / AMD Ryzen 7 5800X or higher |
| RAM | 16 GB DDR4 |
| GPU | NVIDIA RTX 2070 / AMD RX 6700 XT or better |
| Storage | NVMe SSD |
Ryujinx’s high-accuracy focus means it generally requires more hardware power than performance-optimized Switch emulators. On Steam Deck, performance varies significantly by game — simpler 2D titles run well, while demanding 3D games may require reduced resolution and graphics settings.
What Are Ryujinx Prod Keys?
Ryujinx prod keys are cryptographic decryption keys stored in a file called prod.keys. They are the same keys that a physical Nintendo Switch uses internally to decrypt encrypted game content during normal operation. When you run a game in Ryujinx, the emulator needs to perform the same decryption operations — the prod.keys file provides the key data required to do this in software.
What the prod.keys file decrypts
- Game files (NSP — eShop downloads, XCI — cartridge images): all Switch game content is encrypted. Without prod.keys, Ryujinx cannot read any game file.
- Updates and DLC: content updates and downloadable content use the same encryption system and require the same keys.
- System NCA files: Nintendo Content Archives containing game code, assets, and metadata are encrypted and require keys to decompress and read.
- Title metadata: the display name, icon, and version information shown in the game list require key-based decryption to read correctly.
Prod keys vs title keys
Ryujinx uses two key files:
- prod.keys — contains master keys, header keys, key area encryption keys, and other system-level cryptographic material. Required for all Switch emulation.
- title.keys — contains per-game encryption keys for individual game titles, primarily relevant for digital (eShop) games tied to a Nintendo account. Some game setups require this file in addition to prod.keys; others work with prod.keys alone.
Both files belong in the same system folder. If you dumped keys using Lockpick_RCM, both files are generated automatically.
What Is Ryujinx Firmware?
Ryujinx firmware is the Nintendo Switch operating system, installed inside the emulator to provide the system-level services that Switch games depend on at runtime. Where prod.keys decrypt game content so it can be read, firmware provides the environment in which the decrypted code actually runs.
When a Switch game executes, it continuously calls system services provided by the Switch OS — audio playback, controller input, file system access, network connectivity, error handling, font rendering, and dozens of background processes. Ryujinx’s firmware package provides these services in emulated form, allowing game code to function as it would on real hardware.
What Ryujinx firmware contains
- System modules (sysmodules): background processes providing core OS functions — audio (audren/audout), controller input (hid), file system (fs), network (ldn/bsd), and others
- System applets: the built-in Switch UI components — software keyboard, home menu, error screens, controller pairing screens
- NintendoSDK libraries: shared code libraries that games link to at runtime for common functions
- Font data: the system fonts that Ryujinx uses when games request text rendering through the OS font service
- MII data and other system assets: shared resources used across multiple games
Ryujinx Prod Keys and Firmware: Why Both Are Required
| File | Function | What Fails Without It |
| prod.keys | Decrypts encrypted Switch game files, updates, and DLC | Games cannot be loaded — Ryujinx shows ‘RYU-0001 Keys not found’ or black screen |
| title.keys | Decrypts per-title keys for digital game content | Specific digital titles may fail to load or show DRM errors even with prod.keys |
| Firmware | Provides OS-level services that game code calls at runtime | Games may decrypt but immediately crash when making OS service calls |
Ryujinx’s stricter validation compared to other Switch emulators means it requires both prod.keys and firmware for most games, even for simple titles that other emulators might partially run without one or both files. This strictness is the trade-off for Ryujinx’s higher accuracy — it more completely replicates the Switch environment, which requires the complete set of system files to do so.
Where to Put Prod Keys in Ryujinx: All Platforms
Quick method: all platforms
The easiest way to find the correct folder on any platform:
- Open Ryujinx
- Click File in the top menu bar
- Select Open Ryujinx Folder
- This opens the main Ryujinx data directory in your file explorer
- Open the system folder inside that directory
- Paste your prod.keys and title.keys files directly into the system folder
- If no system folder exists, create a new folder and name it exactly system
Windows — manual path
C:\Users\[YourUsername]\AppData\Roaming\Ryujinx\system\
The AppData folder is hidden by default on Windows. Access it by pressing Windows Key + R, typing %appdata%, and pressing Enter. This opens the Roaming folder directly. Navigate to Ryujinx → system from there.
Linux — manual path
~/.config/Ryujinx/system/
The .config folder is a hidden directory in your home folder. Access it by pressing Ctrl+H in your file manager to show hidden folders, or navigate directly using the terminal with cd ~/.config/Ryujinx/system.
macOS — manual path
~/.config/Ryujinx/system/
Same path as Linux. Access it through Finder by pressing Cmd+Shift+G and typing ~/.config/Ryujinx/system to navigate directly.
Steam Deck — manual paths
Steam Deck uses Linux but has two possible paths depending on how Ryujinx was installed:
- Standard installation: /home/deck/.config/Ryujinx/system
- Discover Store / Flatpak installation: ~/.var/app/org.ryujinx.Ryujinx/config/Ryujinx/system
To access these on Steam Deck: press the Steam button → Power → Switch to Desktop Mode. Open the Dolphin file manager. Press Ctrl+H to show hidden files and folders. Navigate to the correct path above. Once keys are placed, switch back to Gaming Mode from the taskbar.
How to Install Ryujinx Firmware
Firmware is installed through the Ryujinx interface, not by manually copying files. The Tools → Install Firmware option handles unpacking and placing the firmware components in the correct internal locations.
Method 1: Install from a ZIP file
- Obtain your Switch firmware ZIP file (from your own Switch using a homebrew dumping tool)
- Open Ryujinx
- Click Tools in the top menu
- Select Install Firmware
- Choose Install a firmware from XCI or ZIP
- Navigate to your firmware ZIP file and select it
- Click Open
- A confirmation dialog appears — click Yes
- Wait for the installation progress bar to complete
- Close and restart Ryujinx
After installation, the firmware version is displayed at the bottom of the Ryujinx window in the status bar. If you see a version number, firmware installed correctly.
Method 2: Install from an XCI file
If your firmware is in XCI format (a dumped system cart), the process is identical — select the XCI option in step 5 of the above process. Ryujinx handles both ZIP and XCI firmware formats.
How to Get Ryujinx Prod Keys Legally
Ryujinx prod.keys must be obtained by dumping them from a Nintendo Switch you own. The process requires a hackable Switch unit (first-generation models manufactured before approximately June 2018 are vulnerable; check your serial number using online Switch hackability databases) running custom firmware.
Step 1: Verify your Switch is hackable
Check your Switch serial number against a hackability database (search ‘Switch serial number hackability checker’). First-generation Switch units with serial numbers starting with XAW1, XAW4, XAW7, XAJ1, or XAJ4 with numbers in the vulnerable range are typically hackable. Patched Switches, Switch Lite, Switch OLED, and V2 models are generally not hackable with current public methods.
Step 2: Install Atmosphere custom firmware
Atmosphere is the standard custom firmware for Nintendo Switch. Download the latest release from the official Atmosphere GitHub repository and follow the setup guide for your specific Switch model. Your Switch needs an SD card and a jig (or paperclip) to enter RCM mode.
Step 3: Use Lockpick_RCM to dump keys
Lockpick_RCM is a key-dumping payload that runs directly on the Switch hardware:
- Download the Lockpick_RCM payload file
- Place the payload on your SD card
- Boot your Switch into RCM mode (jig in the right Joy-Con rail + Volume Up + Power)
- Inject the payload via your PC using a USB-C connection and a payload injector tool (TegraRcmGUI or fusee-launcher)
- In the Lockpick menu, select Dump from SysNAND
- The process takes a few seconds and saves prod.keys and title.keys to /switch/ on your SD card
Step 4: Transfer files to your PC
Remove the microSD card from your Switch and copy the prod.keys and title.keys files to your PC. Place both files in the Ryujinx system folder as described above.
How to Verify Your Ryujinx Prod Keys Setup
After placing your key files and installing firmware, verify everything is working before attempting to load games:
- Open Ryujinx
- Click Options in the menu bar
- Select Settings
- Navigate to the System tab
- Scroll to the Keys section — you should see a green checkmark or file path listed for both prod.keys and title.keys
- Close Settings
- Check the bottom status bar of the Ryujinx window — if firmware is installed, you will see a firmware version number (e.g., ‘Firmware: 22.5.0’)
If both the keys paths and firmware version are displayed correctly, your setup is complete. Test by loading a game from your library.
Ryujinx Canary Prod Keys: Is There a Difference?
Ryujinx Canary is an experimental build of Ryujinx that receives updates more frequently than the main release. It uses the same prod.keys file and the same firmware package as the stable release. There is no separate ‘Ryujinx Canary prod keys’ file — a prod.keys file that works in the stable Ryujinx build will work identically in Canary.
The Canary keys folder path is the same on all platforms:
- Windows: %AppData%/Ryujinx/system/ — same as stable build
- Linux/macOS: ~/.config/Ryujinx/system/ — same as stable build
If you have already set up the stable build with prod.keys and firmware, Canary will use the same system folder and recognize your existing key files automatically.
Ryubing Prod Keys and Firmware
Ryubing is an active fork of Ryujinx that continues development independently from the main Ryujinx project. It uses the same prod.keys and firmware format as Ryujinx — the same file you use for Ryujinx works for Ryubing without any modification.
Ryubing’s keys folder path differs from Ryujinx:
- Windows: %AppData%/Ryubing/system/ (or the path shown in Ryubing’s File → Open Ryubing Folder)
- Linux/macOS: ~/.config/Ryubing/system/
Use File → Open Ryubing Folder in Ryubing’s interface to find the correct path, then place prod.keys and title.keys in the system subfolder.
Common Ryujinx Prod Keys Errors and Fixes
| Error | Cause | Fix |
| RYU-0001 ‘Keys not found’ | prod.keys file is missing or in the wrong location | Place prod.keys in the system folder; use File → Open Ryujinx Folder to find the exact path |
| ‘Ryujinx was unable to find your prod.keys file’ | Same as above — keys not in system folder | Verify file name is exactly prod.keys; ensure it is not in a subfolder |
| Game list is empty or games do not appear | Keys not loaded when game directory was scanned | Place keys first, restart Ryujinx, then add game directory |
| Black screen on game launch | Firmware not installed | Install firmware via Tools → Install Firmware |
| Game crashes immediately after title screen | Outdated firmware — game requires newer firmware version | Update firmware to match or exceed the game’s required version |
| DLC or updates fail to install | Missing or outdated title.keys | Ensure title.keys is in the system folder alongside prod.keys |
| Newer games crash but older ones work | prod.keys is outdated — lacks keys for new firmware versions | Re-dump prod.keys from your Switch after updating its firmware |
| ‘NCA header key is not found’ | Keys file is corrupted or incomplete | Re-dump keys from your console; verify file size is approximately 6–10 KB |
Ryujinx Prod Keys Location: Full Folder Structure
| File/Folder | Purpose |
| system/prod.keys | Main decryption keys — required for all game decryption |
| system/title.keys | Per-game title keys — required for digital/eShop games |
| system/dev.keys | Developer console keys — rarely needed for standard game emulation |
| system/ (firmware NCAs) | Installed firmware files — managed by Ryujinx after Tools → Install Firmware |
| games/ | Location for NSP and XCI game files (optional; configurable) |
| bis/user/save/ | Emulated NAND storage for game saves |
| sdcard/ | Emulated SD card contents |
Ryujinx is open-source — for the official GitHub repository, build downloads, and issue tracking, see github.com/Ryujinx/Ryujinx.
For the Atmosphere custom firmware project (required for dumping keys from your Switch), see github.com/Atmosphere-NX/Atmosphere.
Bottom Line
| What prod.keys does | Decrypts Nintendo Switch game files (NSP/XCI), updates, and DLC |
| What firmware does | Provides OS services (audio, input, filesytem) that game code calls at runtime |
| Are both required? | Yes — Ryujinx strictly requires both for most games |
| Keys location (Windows) | %AppData%/Ryujinx/system/prod.keys and title.keys |
| Keys location (Linux/macOS) | ~/.config/Ryujinx/system/ |
| Steam Deck (standard) | ~/.config/Ryujinx/system/ |
| Steam Deck (Flatpak) | ~/.var/app/org.ryujinx.Ryujinx/config/Ryujinx/system/ |
| Firmware install method | Tools → Install Firmware → select your firmware ZIP or XCI |
| Canary build | Uses the same prod.keys and firmware as the stable build |
| Ryubing | Same prod.keys format; different folder — use File → Open Ryubing Folder |
| Legal requirement | Keys must be dumped from a Nintendo Switch you own using Lockpick_RCM |
Frequently Asked Questions
What is Ryujinx firmware and why do I need it?
Ryujinx firmware is the Nintendo Switch operating system installed inside the emulator. Switch games do not contain all the code they need to run — they depend on system services provided by the Switch OS at runtime, including audio, controller input, file system access, and system fonts. Without firmware, Ryujinx can decrypt game files using prod.keys but the games will immediately crash when they try to call OS services that are not present. Install firmware via Tools → Install Firmware in the Ryujinx menu.
Where do I put prod.keys in Ryujinx?
On Windows, prod.keys goes in %AppData%/Ryujinx/system/ (press Windows+R and type %appdata% to get to this folder quickly). On Linux and macOS, the path is ~/.config/Ryujinx/system/. On Steam Deck, it is ~/.config/Ryujinx/system/ for standard installs, or ~/.var/app/org.ryujinx.Ryujinx/config/Ryujinx/system/ for Flatpak installs. The fastest method on any platform: open Ryujinx, click File → Open Ryujinx Folder, then place prod.keys in the system subfolder.
How do I fix the Ryujinx ‘prod.keys not found’ error?
The ‘RYU-0001 Keys not found’ or ‘prod.keys not found’ error means Ryujinx cannot find your prod.keys file. To fix it: use File → Open Ryujinx Folder to find the exact system folder path for your installation; ensure your prod.keys file is placed directly in the system folder (not a subfolder inside it); verify the file is named exactly prod.keys with no additional extensions; restart Ryujinx after placing the file. If the error persists, check that your prod.keys file is not corrupted — a valid prod.keys file is approximately 6–10 KB in size.
Do Ryujinx Canary and stable use the same prod.keys?
Yes. Ryujinx Canary and the stable Ryujinx release use exactly the same prod.keys file and firmware. There is no separate ‘Canary prod keys’ — a prod.keys file that works in stable Ryujinx works identically in Canary. Both builds use the same system folder location, so if you have already set up keys and firmware for one build, the other build will recognize them automatically.
What is the difference between Ryujinx and Ryubing?
Ryubing is an independent fork of Ryujinx that continues development as a separate project. It uses the same prod.keys and firmware format, so you do not need separate files for each emulator. The difference is the folder location: Ryubing stores its files in a Ryubing folder rather than Ryujinx. Use File → Open Ryubing Folder in the Ryubing interface to find the correct path, then place prod.keys and title.keys in the system subfolder there.
Why do newer games fail in Ryujinx even with prod.keys installed?
Newer games fail when your prod.keys file does not contain the decryption keys for the firmware version that encrypted them. Each new Nintendo Switch firmware version introduces new encryption keys. A prod.keys file dumped from a Switch running firmware 20.5.0 contains keys up to that version — it cannot decrypt content encrypted by firmware 22.0.0 or later. To fix this, update your Switch to the latest firmware using official Nintendo channels, then re-dump prod.keys using Lockpick_RCM to get an updated key file containing all current key generations.
