Skip to content

Installing

Letalys edited this page Sep 20, 2026 · 3 revisions

Français · English

Installing

Before installing, see the Requirements page.


Download

The files are on the Releases page of the GitHub repository.

Version File Description
Installer (recommended) RomStation-Rebase_x.x.x.msi Installs RSRebase with a shortcut and an uninstaller
Portable RomStation-Rebase_x.x.x.zip Extract it anywhere, then run RomStationRebase.exe

Both versions ship the .NET 10 runtime: nothing else needs to be installed.

Windows may show a SmartScreen warning the first time the MSI runs. Click More info, then Run anyway.


First launch

Splash
  • RomStation installed with its setup program: nothing to do
  • RomStation as a portable ZIP: a window asks for the RomStation folder, the one that contains RomStation.cfg. The location is remembered

Where RSRebase keeps its data

%LOCALAPPDATA%\RomStationRebase\
Item Content
user-preferences.json Language, theme, window sizes, last rebase settings
app-state.json RomStation location, last update check
database\ Copy of the RomStation database, made again at every startup
architectures\ The target architectures, the default ones and your own
tools\ The external tools and the location of their executable
logs\ The rebase logs
work\ Work folder for conversions, emptied after use

The Open RSRebase data folder button of the Settings leads there. Uninstalling RSRebase does not remove this folder.


Updating RSRebase

Knowing that a version is out

Once a day, RSRebase checks whether a newer version is published on GitHub. It downloads and installs nothing.

  • Status bar of the main window: ↑ Update available: 1.4.0. A click opens the page of that version on GitHub
  • Footer of the Settings window: the installed version, followed by Version 1.4.0 is available.
  • Settings, About section: the Check for updates button runs the check right away
Settings: version and updates in the window footer

Every version is on the Releases page, with its release notes.

Installing the new version

Close RSRebase, then:

  • MSI installer: download the new .msi and run it. It replaces the old version, with no need to uninstall first
  • Portable ZIP: extract the new .zip and replace the content of the old folder

Preferences, architectures, external tools and logs stay in %LOCALAPPDATA%\RomStationRebase\.

After updating

  • A default architecture or tool added by the new version shows up at first launch
  • Your architectures and tools are never overwritten, not even the default ones you modified. To get the fixes made to default architectures: Restore default architectures, in the architecture editor. Your custom architectures are kept

Coming from 1.2.0

  • An architecture written by hand in the old config\architectures folder has to be created again in the architecture editor
  • Multi-file games, arcade romsets and games sharing a title no longer get the same name as before. On a card filled by 1.2.0, they will be copied again. Single-file games keep their name

Problems at startup

See the Troubleshooting page.

Clone this wiki locally