Egghead.page Logo

How to Backup RetroArch Configurations on Linux

RetroArch is a powerful frontend for emulators, but losing your settings can be frustrating after a system update or reinstall. This guide outlines the recommended method for backing up RetroArch configurations on Linux systems to preserve your customizations. We will cover locating the specific configuration directory, using command-line tools for efficient copying, and automating the process to ensure your custom controls, shaders, and core settings remain safe.

Locate the Configuration Directory

On most Linux distributions, RetroArch stores its configuration files within the user’s home directory. The primary path is typically ~/.config/retroarch/. Inside this folder, the main configuration file is named retroarch.cfg. Additionally, this directory often contains subfolders for saves, states, shaders, and overlays. Identifying this path is the critical first step before attempting any backup procedure, as default installation paths can vary slightly depending on whether you installed via a package manager, Flatpak, or compiled from source.

Manual Backup Using the Terminal

The most reliable method for backing up these files is using the terminal with the cp or rsync commands. Open your terminal and create a dedicated backup folder in your home directory or an external drive. You can copy the entire configuration directory recursively to ensure all subfolders are included. For example, running cp -r ~/.config/retroarch/ ~/retroarch_backup/ creates a complete snapshot of your current setup. Using rsync is often preferred for subsequent backups because it only transfers changed files, saving time and storage space while maintaining an exact mirror of the source directory.

Automating the Backup Process

To prevent data loss due to forgetfulness, you can automate the backup process using a cron job or a systemd timer. Create a simple shell script that executes the rsync command mentioned previously and schedules it to run weekly or monthly. This ensures that every time you tweak your controller mappings or update your shader presets, those changes are archived without manual intervention. Automation is particularly useful for Linux users who frequently update their system packages, as configuration files can sometimes be overwritten during major upgrades.

Restoring Your Configuration

Restoring your RetroArch setup is simply the reverse of the backup process. If you need to recover your settings, ensure RetroArch is closed completely to prevent file conflicts. Use the cp command to overwrite the current configuration directory with your backed-up folder. Once the files are replaced, launch RetroArch to verify that your cores, inputs, and video settings have returned to their previous state. Regularly testing your backup by performing a restoration on a test directory ensures that your backup files are not corrupted and are ready for emergency use.