How to Install Ryujinx Canary on Steam Deck

What is Ryujinx Canary?

Ryujinx is a Nintendo Switch emulator that lets you play Switch games on other hardware. The Canary build is the cutting-edge version — it receives updates more frequently than the stable release and often includes improved game compatibility and performance fixes before they hit the official stable channel.

The original Ryujinx project was shut down in October 2024 after Nintendo contacted the lead developer. However, community-maintained forks under the Ryujinx Canary name continue active development and are fully functional on Steam Deck.

Legal note: Ryujinx is legal emulator software. However, you must dump your own Switch game cartridges and firmware from a console you own. Downloading games or firmware from the internet may violate copyright law in your country.

Also Read > full Ryujinx Canary safety guide

What you need before starting

Requirement	Details
Device	Steam Deck (any model)
Storage	~500 MB free minimum
Keys File	prod.keys (from your Switch)
Firmware	Nintendo Switch firmware dump
Game Files	NSP or XCI format
Mode	Desktop Mode for setup

Tip: All setup must be done in Desktop Mode. Hold the Power button → Switch to Desktop to get there. Before you begin, make sure you have your prod.keys ready — follow our Ryujinx prod.keys guide if you haven’t set that up yet.

Canary vs. Stable — which should you pick?

Feature	Canary	Stable
Update frequency	Very frequent	Less frequent
Game compatibility	Better (latest fixes)	Good (proven builds)
Risk of bugs	Slightly higher	Lower
Best for	New game support & testers	Stable, set-and-forget setups
Steam Deck support	Yes (x64 AppImage)	Yes (x64 AppImage)

For most Steam Deck users who want the best game compatibility, Canary is the recommended choice. It receives the latest fixes and is fully tested on Linux and SteamOS. Still unsure? Read our full Ryujinx Canary vs Stable comparison.

Also Read > Ryujinx Stable vs Canary performance breakdown

Step-by-step installation

Method 1: Manual AppImage (recommended for full control)

Step 1: Switch to Desktop Mode

Press and hold the Power button. Select Switch to Desktop. The full KDE desktop environment will load.

Step 2: Download the Linux x64 AppImage

Open Firefox. Go to the Ryujinx Canary download page and download the x64 AppImage. This is the correct build for Steam Deck — do not download the ARM64 version, it will not work.

Step 3: Make the AppImage executable

Open Dolphin (the file manager). Navigate to your Downloads folder. Right-click the AppImage → Properties → Permissions → check Is executable. Or open Konsole and run: chmod +x Ryujinx_Canary_*.AppImage

Step 4: Launch Ryujinx Canary

Double-click the AppImage. Ryujinx will open for the first time and create its config folders automatically at ~/.config/Ryujinx.

Also Read > Ryujinx PC setup guide

Method 2: Via EmuDeck (easier for beginners)

EmuDeck is an all-in-one emulation setup tool that installs Ryujinx automatically. Visit emudeck.com, download the installer, run it in Desktop Mode, and select Ryujinx during the setup process. EmuDeck handles folder structure, ROM manager integration, and Gaming Mode shortcuts automatically.

EmuDeck tip: If you later switch to the Canary AppImage, point the Ryujinx executable in EmuDeck / Steam ROM Manager to the new Canary AppImage file and update the path each time you upgrade.

Also Read > Ryujinx vs Yuzu vs Eden: Best Nintendo Switch Emulators

First-time setup — keys, firmware & games

Step 1: Install your prod.keys

Without decryption keys, Ryujinx cannot read any game files. In Ryujinx, go to Actions → Install Keys (or Tools → Install Keys depending on your build version). Point it to your prod.keys file. These must be dumped from your own Nintendo Switch using tools like Lockpick_RCM.

Step 2: Install Switch firmware

Go to Tools → Install Firmware and select your firmware archive. Once installed, Ryujinx should stop prompting for firmware on launch. If it still asks, restart the app.

Step 3: Add your game directories

Go to Options → Settings → General and under Game Directories, click Add. Navigate to the folder containing your .nsp or .xci game dumps. Click Apply, then OK. Your games will appear in the main list after a scan. See our guide on how to add games in Ryujinx for file format and folder setup instructions.

Important: If Ryujinx does not start after a previous install, your old config may be conflicting. Back up ~/.config/Ryujinx by renaming it (e.g. to Ryujinx.bak), then relaunch — this forces a clean first-run setup. If problems persist, visit our Ryujinx troubleshooting guide for common fixes.

Also Read: How to Install DLC and Updates in Ryujinx / Ryubing Emulator

Graphics settings for Steam Deck

For best performance on Steam Deck hardware, use these settings under Options → Settings → Graphics:

Setting	Recommended value
Graphics backend	Vulkan recommended
Resolution scale	1x (native)
Anisotropic filtering	4x or Auto
V-Sync	On (reduces tearing)

Also Read > Ryujinx graphics enhancements guide

Adding Ryujinx Canary to Gaming Mode

To play without going through Desktop Mode every time, add Ryujinx to Steam:

Step 1: Open Steam in Desktop Mode

Launch Steam from the taskbar or application launcher.

Step 2: Add a non-Steam game

Click Games in the menu bar → Add a Non-Steam Game to My Library → click Browse and navigate to your Ryujinx Canary AppImage file.

Step 3: Return to Gaming Mode

Click the Return to Gaming Mode icon on the desktop. Ryujinx will appear in your Library under Non-Steam games. Use Steam Input to configure controller layouts there too.

EmuDeck users: Use the Steam ROM Manager inside EmuDeck to add individual Switch game shortcuts to Gaming Mode with artwork and metadata automatically.

Common Questions

Ready to play?

Download the x64 AppImage, install your keys and firmware, add your games — and you’re good to go. Most Switch titles run well on Steam Deck with Vulkan enabled.