Articles in this section

Database update error on startup

Avatar
Aronium Support
Updated
Follow

On this page:

If you see one of these error messages when starting Aronium:

or

It means that the latest Aronium update included a required database update, but the database update could not be completed due to an error. This database update is critical for proper Aronium functionality.

What should I do?

  1.  If you got the first screen please press Retry database update button (#1). This should fix your problem. 

  2. If you got second screen or if Retry database update button did not work then please follow these steps: 

    • Click Copy to clipboard (#1) in the error dialog.
    • Paste the copied information into an email and send it to support@aronium.com. This information will help us identify the cause of the failure and provide a solution.
    • Then please see Possible recovery steps below

Can I continue using Aronium?

You can continue using Aronium, but it may behave unpredictably or become unstable until the issue is resolved.

Possible recovery steps

In some cases, downloading and reinstalling the latest version of Aronium resolves the issue and completes the database update successfully. Before trying again, please do the following:

  1. Close Aronium completely on all computers.
  2. Restart the computer where the database is located.
  3. Temporarily pause any cloud sync, automatic backup, or antivirus scanning that may be accessing the database file.
  4. Start Aronium again and try the update once more.

Manually run database updates

If you are using Aronium Lite, you can follow instructions below to try running database update manually.

Aronium Lite users only

This option applies to Aronium Lite only. Do NOT try this if you are using Aronium Pro!

Default database location

This option works only if you haven't moved Aronium Lite database from its default location.

This error usually means that the Aronium Lite database file is currently locked by another process or connection while Aronium is trying to update the database structure. This can happen if Aronium is still open in the background, if another computer/register is using the same database, or if another program such as antivirus, backup, OneDrive/Google Drive/Dropbox sync, or a similar tool is accessing the database file at the same time.

To run migrations manually and see if that fixes the problem, follow the steps below. The installation takes few minutes only.

Depending on the Aronium version you have running, you should select the correct next steps: 

If you are using Aronium version 1.49 or lower:

1. Download Aronium Migration application installer

Download Database Migration application installer from https://download.aronium.com/tools/migration/Aronium.Migration.Lite.exe, You will use this application later to initialize database update.

2. Restart computer to ensure no applications are accessing the database

Before proceeding to next steps, restart your computer to make sure no application is accessing the database.

3. Run previously downloaded Aronium Migration installer

Before running Aronium or any other application, run previously download Aronium Migration installer (Aronium.Migration.Lite.exe).

Follow the on screen instructions and complete the installer. 

4. Start Aronium Migration

On the last step, you will have an option to Launch Aronium Migration. Leave it selected and click Finish.

5. Confirm the migration and check for results

On the application start, you will be asked for confirmation. Press "Y" button on the keyboard.

Once you confirm the execution, the application will attempt to run database update. The expected output is similar to the one below:

------------------------------------------------------------------------
 * Migrations status:          SUCCESS
 * Execution time:             144 ms
 * Migration completed at:     14.6.2026. 23:48:22
------------------------------------------------------------------------

If you are seeing "SUCCESS" message, similar to the one above, you can close the app and run Aronium. The database error should be gone.

 

If you are using Aronium version 1.50: 

1.  Restart computer to ensure no applications are accessing the database

Before proceeding to next steps, restart your computer to make sure no application is accessing the database.

2. Start Migration tool from Aronium installation folder

Open Aronium's installation folder at C:\Program Files\Aronium, and find and run Migration.exe

3. Confirm the migration and check for results

On the application start, you will be asked for confirmation. Press "Y" button on the keyboard.

Once you confirm the execution, the application will attempt to run database update. The expected output is similar to the one below:

------------------------------------------------------------------------
 * Migrations status:          SUCCESS
 * Execution time:             144 ms
 * Migration completed at:     14.6.2026. 23:48:22
------------------------------------------------------------------------

If you are seeing "SUCCESS" message, similar to the one above, you can close the app and run Aronium. The database error should be gone.

 

Related articles