Many users install Ryujinx but get confused about where the firmware and prod keys should go. Without these files in the right location, the emulator cannot decrypt game files or load system components required for gameplay.
This guide explains exactly where to put Ryujinx firmware and keys on Windows, Linux, macOS, and EmuDeck setups, along with clear explanations of how these files work together to make Nintendo Switch emulation function properly.
What Are Ryujinx Firmware and Keys?
To understand where these files should be placed, it is important to first understand what firmware and keys actually do inside the emulator.
Prod Keys and Title Keys
Prod keys and title keys are cryptographic files extracted from a real Nintendo Switch console. These keys allow Ryujinx to decrypt encrypted Nintendo Switch game data so the emulator can read and run the files properly.
They perform several important functions:
- Decrypt game files such as NSP and XCI packages.
- Verify system components used by the emulator.
- Allow the emulator to access the encrypted content required to launch games.
Without valid keys installed, Ryujinx will not be able to load games and will often display errors such as “The title is encrypted” or missing keys warnings.
Ryujinx Firmware
Firmware contains the core operating system components of the Nintendo Switch. It includes essential modules, fonts, drivers, and system services that games rely on during gameplay.
Key roles of firmware include:
- Providing system libraries and services used by games.
- Ensuring compatibility with newer Nintendo Switch titles.
- Allowing the emulator to accurately simulate the Switch system environment.
Because many modern games depend on features introduced in newer firmware versions, installing updated firmware is often necessary to launch recent titles.
Because both components serve different purposes, they are stored in different locations within the emulator’s directory structure.
Where to Put Ryujinx Keys (prod.keys and title.keys)
The keys folder is where Ryujinx looks for the cryptographic files needed to decrypt games. Once placed here, the emulator will automatically detect them during startup.
On most systems, the keys should be placed inside the system folder created by Ryujinx.
Default Ryujinx Keys Location
Windows
C:\Users\USERNAME\AppData\Roaming\Ryujinx\system
Linux
~/.config/Ryujinx/system
macOS
~/Library/Application Support/Ryujinx/system
Inside this folder you should place:
prod.keys
title.keys
After copying the files, restart Ryujinx so the emulator can detect them. If the keys are valid, the warning about missing keys will disappear.
Users running Ryujinx through EmuDeck will typically place keys in the EmuDeck BIOS directory:
Emulation/bios/ryujinx/keys
EmuDeck automatically links this folder to the emulator’s internal system directory.
Where Ryujinx Stores Firmware
Unlike keys, firmware is not manually copied into a folder. Instead, Ryujinx installs firmware through its internal installer.
When firmware is installed using the emulator menu, Ryujinx automatically extracts and stores the system files in its registered firmware directory.
Ryujinx Firmware Location
Windows
C:\Users\USERNAME\AppData\Roaming\Ryujinx\bis\system\Contents\registered
Linux
~/.config/Ryujinx/bis/system/Contents/registered
macOS
~/Library/Application Support/Ryujinx/bis/system/Contents/registered
This folder contains the decrypted firmware components used by the emulator when launching games. Users generally should not modify these files manually, since the installation tool manages them automatically.
How Firmware and Keys Work Together
Firmware and keys serve different roles but must work together for the emulator to function correctly.
Keys handle decryption. They allow Ryujinx to read encrypted game files and system modules that originate from the Nintendo Switch. Without keys, the emulator cannot verify or access the contents of game packages.
Firmware provides the operating system environment. It contains the internal system components that games rely on, such as fonts, system services, and hardware interfaces.
Because of this relationship, both files must be installed and compatible. If your keys are outdated while the firmware is newer, the emulator may fail to install or verify the firmware. Keeping both files updated together helps maintain stable emulation.
Common Setup Mistakes and How to Avoid Them
Many setup problems occur when files are placed in the wrong location or installed incorrectly in Ryujinx. Below are some common mistakes and simple ways to avoid them.
1. Manually Copying Firmware Files
Mistake: Placing firmware files directly inside the system folder.
Fix: Always install firmware through Tools → Install Firmware inside Ryujinx. The emulator will automatically extract and place the files in the correct directory.
2. Installing Firmware Before Keys
Mistake: Attempting to install firmware without first adding the required keys.
Fix: Place prod.keys and title.keys in the correct keys folder before installing firmware. Ryujinx uses these keys to verify firmware during installation.
3. Using Outdated or Missing Keys
Mistake: Using old keys that do not match the firmware version.
Fix: Update your keys regularly so they remain compatible with newer firmware versions and game releases.
4. Placing Keys in the Wrong Folder
Mistake: Storing keys in random folders where the emulator cannot detect them.
Fix: Always place prod.keys and title.keys inside the Ryujinx system keys directory so the emulator can read them automatically.
5. Restarting the Emulator After Installation
Mistake: Not restarting Ryujinx after adding keys or installing firmware.
Fix: Restart the emulator so it can reload the newly added system files and apply the changes correctly.
Final Thoughts
Setting up firmware and keys correctly is one of the most important steps when configuring Ryujinx. Keys should always be placed in the system keys folder, while firmware must be installed using the emulator’s built-in installer.
Once both components are configured properly, Ryujinx can decrypt game files, load system services, and run Nintendo Switch games smoothly across supported platforms such as Windows, Linux, macOS, and devices like the Steam Deck.
Following the correct folder structure and installation process ensures the emulator remains stable, compatible with newer games, and ready for future firmware updates.
