Skip to main content
Ryujinx stores all configuration in a Config.json file located in your Ryujinx data folder. This guide covers accessing configuration files and understanding key settings.

​
Accessing Configuration

1

Open Ryujinx Folder

Access your Ryujinx configuration directory:From the GUI:
  1. Open Ryujinx
  2. Click File > Open Ryujinx Folder
  3. Your data directory will open in your file manager
2

Locate Config.json

In the Ryujinx folder, you’ll find:
Ryujinx/
├── Config.json          # Main configuration file
├── games/               # Save data and per-game configs
├── profiles/            # User profiles
├── system/              # Firmware and keys (prod.keys)
├── mods/                # Global mods directory
└── sdcard/              # Virtual SD card
3

Backup Configuration

Important: Always backup Config.json before manual edits:
cp Config.json Config.json.backup

​
Configuration File Location

The Ryujinx data folder location depends on your operating system and launch mode:
User Profile Mode:
C:\Users\<YourUsername>\AppData\Roaming\Ryujinx\
Portable Mode:
<RyujinxInstallDirectory>\portable\
Portable mode is automatically enabled if a portable folder exists in the Ryujinx installation directory.

​
System Settings

Configure core system emulation settings:

​
Language and Region

1

Open Settings

Navigate to File > Settings > System
2

Configure Language

Select your preferred system language:
  • American English (default)
  • British English
  • Japanese
  • French
  • German
  • Spanish
  • Italian
  • And more…
Changing the language requires restarting the emulator and may require refreshing the game library.
3

Set Region

Choose your region:
  • USA (default)
  • Europe
  • Japan
  • Australia
  • China
  • Korea
  • Taiwan
Region affects game compatibility and available content.

​
Time and Time Zone

Match System Time:
  • ☑ Enabled: Use your computer’s current time
  • ☐ Disabled: Set a custom time and date
Custom Time Settings:
"SystemTimeOffset": 0,
"MatchSystemTime": false
Time Zone:
  • Select from 400+ time zones
  • Default: UTC
  • Affects in-game time-based events

​
Docked Mode

Switch between handheld and docked mode:
Default setting - Emulates the Switch in TV mode:
  • Higher resolution output (1080p)
  • Better performance in some games
  • TV-optimized UI layouts
"DockedMode": true

​
Memory Configuration

​
Memory Manager Mode

Ryujinx offers three memory management modes:

Host Mapped (Unsafe)

Default - Fastest performanceUses direct memory mapping for maximum speed. Recommended for most users.

Host Mapped (Checked)

Balanced performance and safetyAdds bounds checking with minimal performance impact.

Software

Maximum compatibilitySlower but most compatible. Use if you experience crashes with host-mapped modes.
"MemoryManagerMode": "HostMappedUnsafe"

​
DRAM Size

Expand emulated system memory:
  • 4 GB (default) - Standard Switch memory
  • 6 GB - Extended memory for better performance
  • 8 GB - Maximum expansion
Increasing DRAM size may improve performance in some games but can cause issues in others. Use 4GB unless a specific game requires more.

​
Profiled Persistent Translation Cache (PPTC)

PPTC dramatically reduces game load times:
1

Enable PPTC

In Settings > System, ensure PPTC is enabled:
"EnablePtc": true
PPTC is enabled by default and highly recommended.
2

Initial Cache Generation

First Launch: Game loads normallySecond Launch: Game loads normally, cache builds in backgroundThird Launch+: Significantly faster load times (30-60% reduction)
3

Low Power PPTC

For laptops and power-sensitive systems:
"EnableLowPowerPtc": false
Enable to reduce CPU usage during cache generation.

​
File System Settings

​
Integrity Checks

Validate game file integrity: 
"EnableFsIntegrityChecks": true
  • Enabled (default): Verifies game files are not corrupted
  • Disabled: Faster loading but may allow corrupted data

​
FS Access Log Mode

For advanced debugging: 
"FsGlobalAccessLogMode": 0
  • 0 - Disabled (default)
  • 1 - Log file system reads
  • 2 - Log reads and writes
  • 3 - Verbose logging (performance impact)

​
Network Settings

​
Internet Access

Control emulated internet connectivity: 
"EnableInternetAccess": false
Enabling internet access allows games to connect online. Use with caution and understand your local laws regarding emulation and online services.

​
LAN Play (Multiplayer)

Configure local multiplayer settings:
1

Select Multiplayer Mode

In Settings > Network, choose:
  • Disabled (default)
  • LDN - Local wireless multiplayer
  • LDN + Custom Server - Online multiplayer via LDN server
2

Network Interface

Select the network adapter for LAN play:
"MultiplayerLanInterfaceId": "0"
“0” uses the default network interface.
3

LDN Passphrase (Optional)

Set a 16-character passphrase for private networks:
"MultiplayerLdnPassphrase": ""

​
User Interface Settings

​
Discord Integration

Show your currently playing game on Discord: 
"EnableDiscordIntegration": true

​
Window Behavior

"RememberWindowState": true
Saves window size, position, and maximized state between sessions.
"ShowConfirmExit": true
Displays confirmation when closing Ryujinx to prevent accidental closure.
"HideCursor": "OnIdle"
Options:
  • Never - Always show cursor
  • OnIdle (default) - Hide after inactivity
  • Always - Always hide cursor in game

​
Update Checker

Configure how Ryujinx checks for updates:
  • Prompt at Startup (default) - Shows update dialog when available
  • Show Notification - Displays non-intrusive notification
  • Disabled - Never check for updates
"UpdateCheckerType": "PromptAtStartup"

​
Per-Game Configuration

Ryujinx supports game-specific settings:
1

Access Game Settings

  1. Right-click a game in the library
  2. Select Manage User Configuration
  3. Adjust settings specific to this game
2

Configuration Isolation

Per-game configs override global settings:
  • Graphics settings
  • CPU settings
  • System settings
  • Audio settings
3

Configuration Location

Game configs are stored in:
<RyujinxFolder>/games/<TitleID>/Config.json
Input configuration is always global unless explicitly set to use per-game input.

​
Advanced Settings

​
Ignore Missing Services

"IgnoreMissingServices": false
Some games may require disabling this for compatibility, but it can reduce stability.

​
Ignore Controller Applet

"IgnoreApplet": false
Skips the controller configuration screen when starting games.

​
Skip User Profile Manager

"SkipUserProfiles": false
Automatically uses the configured profile without showing the selection dialog.

​
Resetting Configuration

Resetting configuration will restore all settings to defaults. Your game saves will not be affected.
1

Backup Current Settings

Copy Config.json to a safe location
2

Reset via GUI

  1. Open File > Settings
  2. Click the Reset button (bottom-left)
  3. Confirm the reset
3

Manual Reset

Delete or rename Config.json. Ryujinx will create a new default configuration on next launch.

​
Next Steps

Graphics Settings

Configure graphics backend, resolution, and visual enhancements

Audio Settings

Select audio backend and adjust volume

Input Configuration

Set up controllers, keyboard, and motion controls

Troubleshooting

Diagnose and fix common issues

Build docs developers (and LLMs) love

Get started for freeTalk to us