Skip to main content
All CollectionsModrinth AppErrors and crashes
Migration error during initialization
Migration error during initialization

How do I solve the "migration was previously applied" error?

Jakob avatar
Written by Jakob
Updated this week

Technical explanation

Modrinth App uses an internal database to store information about your instances and settings. Updates to the app may change the database structure through a process known as migration.

When a migration is complete, a record of it is stored in the database, in a table of previously applied migrations. This allows the app to check whether the database is up-to-date or whether it needs to be updated first.

Attempting to launch an older version of the app after the migrations of the newer versions have been applied will result in an initialization error with the following message (visible under the Debug info spoiler):

migration 20240930001852 was previously applied but is missing in the resolved migrations

This safety measure prevents older versions of the app from using an updated database. Without it, the app could crash or behave unpredictably because it wouldn't understand how the newer database organizes information.

Solution

This error occurs when you're trying to run an older version of the app, possibly through an outdated shortcut or installation.

To fix this on Windows:

  1. Uninstall all copies of Modrinth App (see important warning below).

  2. Download and install the latest version from Modrinth website.

🔥 Do not check the "Delete the application data" option.

Checking this box will permanently erase all your profiles and worlds. If you're worried about accidentally selecting this option, you can back up your data by copying the entire %AppData%\ModrinthApp folder before uninstalling.

Visual representation of uninstalling Modrinth App 0.8.5, not selecting "Delete the application data" option, and running the freshly downloaded Modrinth App installer.

Still not working?

If the old version doesn't appear in the installed apps list, you may need to manually uninstall and remove the old files.

To do this:

  1. Right-click the shortcut you use to open Modrinth App.

  2. Select 📂 Open file location from the menu.

    For ⊞ Start menu, this option will open the folder with all your Start menu shortcuts, so you need to find Modrinth App in there and repeat this step.

  3. If present, run the uninstall.exe file (remember the warning above about not deleting application data).

  4. Delete the Modrinth App.exe or theseus_gui.exe files if they remain after uninstallation.

  5. Download and install the latest version of the app from the website.

Visual representation of opening the file location in the Start menu, opening file location for the shortcut file, running uninstall.exe, and deleting the remaining Modrinth App.exe file.

Did this answer your question?