This guide explains how to install, configure, and manage Ryujinx when using EmuDeck. It covers the essential steps required to run Nintendo Switch games, including firmware installation, folder locations, updates, DLC management, and general configuration.
The instructions below are designed primarily for Linux systems such as the Steam Deck, though many of the concepts apply to other platforms where Ryujinx is supported.
Ryujinx (2002-4604) Hash Error Fix
Getting Started with Ryujinx
To run Nintendo Switch games on Ryujinx, several required components must be installed and configured correctly.
First, the emulator requires a prod.keys file. These keys are necessary to decrypt Nintendo Switch game files so the emulator can read and load them. Because Nintendo frequently releases firmware updates, it is important to keep your keys up to date so that newer games remain compatible.
Firmware installation is also required. Firmware provides the system-level components that allow games to run properly. To install firmware, open Ryujinx, click Tools, select Install Firmware, and choose the appropriate installation option depending on whether your firmware file is packaged as ZIP or XCI.
Your game files should be placed inside the Emulation/roms/switch folder. The prod.keys file should be stored in Emulation/bios/ryujinx/keys. Firmware is installed through the Ryujinx interface rather than being manually copied into a folder.
Additional content such as game updates and DLC can also be installed through the Ryujinx interface. For detailed instructions, refer to the DLC and updates section later in this guide.
Ryujinx Configuration
When installed through EmuDeck, Ryujinx uses a predefined folder structure to organize its configuration files, game data, and emulator settings.
Emulator Type: Binary Package
Executable Location:/home/deck/Applications/publish/Ryujinx
or/home/deck/Applications/publish/Ryujinx.sh
Configuration Folder:/home/deck/.config/Ryujinx/
Storage Folder:Emulation/storage/Ryujinx
ROM Location:Emulation/roms/switch
Keys Folder:Emulation/bios/ryujinx/keys
Firmware Installation Method:
Firmware is installed through the Ryujinx interface rather than manually copying files.
Firmware Storage Path:$HOME/.config/Ryujinx/bis/system/Contents/registered
Save Data:/home/deck/.config/Ryujinx/bis/user/save
Because folders such as .config are hidden by default in Linux file managers, you may need to enable Show Hidden Files in the file manager settings to view them.
Ryujinx Folder Structure
The Ryujinx configuration directory contains several important folders that manage emulator data, saves, and system files.
Example structure:
Ryujinx
├── bis
│ ├── system
│ └── user
├── Config.json
├── games
├── mods
├── profiles
├── sdcard
└── system
These directories handle firmware modules, user saves, controller profiles, and system configuration data. In most cases, users do not need to manually modify these folders because Ryujinx manages them automatically.
How to Update Ryujinx
Keeping the emulator updated ensures improved compatibility and performance. Ryujinx can be updated in several ways.
Through the EmuDeck Application
Open the Manage Emulators page in EmuDeck and use the Update your Emulators & Tools section.
Using the Built-in Updater
When Ryujinx launches, it may display a notification if a newer version is available. Accept the update prompt to install the latest release.
Manual Update
Download the latest build from the GitHub releases page and replace the existing binary in the Applications/publish directory.
Using the binupdate Script
Run the script located in:
Emulation/tools/binupdate
How to Launch Ryujinx in Desktop Mode
Ryujinx can be launched in several ways depending on your EmuDeck setup.
Application Launcher
Open the application launcher in Desktop Mode and search for Ryujinx.
Launcher Script
Run the script located at:
Emulation/tools/launchers/ryujinx.sh
Direct Binary Launch
Launch the executable located in:
/home/deck/Applications/publish/Ryujinx
Steam Integration
Add Ryujinx to Steam using Steam ROM Manager, allowing the emulator to launch directly from Game Mode.
Supported Ryujinx File Formats
Ryujinx supports several Nintendo Switch file formats.
Common supported formats include:
.nsp.xci.nca.nro.nso.kp
These formats represent different types of game packages, updates, and system files used by the Nintendo Switch platform.
How to Manage DLC and Game Updates
Game updates and downloadable content (DLC) must be stored separately from ROM files.
Important: Do not place DLC or update files in the Emulation/roms/switch directory because Steam ROM Manager may incorrectly detect them as games.
Instead, store them in:
Emulation/storage/ryujinx/patchesAndDlc
To install DLC or updates:
- Open Ryujinx.
- Right-click the game in your library.
- Select Manage Title Updates or Manage DLC.
- Click Add.
- Navigate to the patchesAndDlc folder.
- Select the update or DLC file.
- Click Save.
Once installed, updates will appear beneath the game title in the Ryujinx game list.
Ryujinx Hotkeys
Ryujinx includes basic keyboard shortcuts for controlling the emulator.
Stop Emulation:Esc
On the Steam Deck, the equivalent shortcut is:
Steam Button or … + D-Pad Left
Additional Tips and Configuration
Ryujinx supports several advanced configuration features.
Gyroscope Controls
Gyro support requires the SteamDeckGyroDSU tool, which can be installed through EmuDeck.
External Controllers
Controllers can be configured through the Input settings inside Ryujinx.
Multiplayer Setup
Additional players can be enabled by assigning extra controller ports in the Input configuration menu.
Game Mods
Mods can be installed by right-clicking a game and selecting Open Mod Data Location, then placing the mod folder inside the opened directory.
Language Settings
Interface language can be changed through:
Options → Change Language
Game language can be configured in:
Options → Settings → System → System Language
Final Notes
Ryujinx works best when keys, firmware, and emulator versions are kept up to date together. Maintaining the correct folder structure and installing updates through the built-in interface will help ensure stable performance and proper compatibility with Nintendo Switch titles.
With the correct configuration, EmuDeck and Ryujinx provide a structured and convenient way to manage Nintendo Switch emulation on devices such as the Steam Deck.
