Install · Linux

Install on Linux

Most PCs and Steam Deck need x86_64; ARM64 hosts need aarch64 assets. Prefer the home page download when possible.

Need the Linux package from GitHub?▾

CI → Continuous Build (Linux…) or a tagged emulator release → Assets. Match x86_64, x86_64_v3, or aarch64 to your CPU (AppImage / archive as listed).

AppImage: chmod +x ./YourFile.AppImage or file properties → allow executing, then run it. Archive (.tar.zst / etc.): extract, then run the binary inside (chmod +x if needed).
Black screen or Vulkan errors after launch? Update GPU / Vulkan drivers for your distro — see Troubleshoot and the readme below.

Steam Deck / SteamOS

Use x86_64 Linux builds only — not aarch64.
Use Desktop Mode for setup; you can Add to Steam on the AppImage for Gaming Mode shortcuts.
Broken profile? See portable data folder (setup).
EmuDeck / Steam ROM Manager: point at the same Citron binary after each upgrade.

Step 3 · First-time setup →Troubleshoot →Download →GitHub links hub →

Emulator readme