Fix There Was an Issue Loading Your Database

Troubleshooting "There Was an Issue Loading Your Database"

These symptoms typically occur when your Roon database can't be read properly by Roon. 

First, try giving your server machine a reboot, many times this will resolve the issue. If that doesn't help, it might be a sign that your database has become corrupt. 

Restoring Roon

If your database is corrupt, you'll want to set your old database aside, start a new database, and then try restoring a backup. Step-by-step instructions below: 

Nucleus

  1. Stop RoonServer from running in Nucleus’s Web UI
  2. Navigate to your Nucleus' Database Location
  3. Find the folder that says “RoonServer”
  4. Rename the “RoonServer” folder to “RoonServer_old”
  5. Restart the RoonServer in the WebUI to generate a new Database
  6. On the Roon Remotes, press "Use another Roon Server" and connect to the new database
  7. Restore a backup

ROCK

  • Stop RoonServer from running in ROCK’s WebUI
  • Navigate to your ROCK’s Database Location
  • Find the folder that says “RoonServer”
  • Rename the “RoonServer” folder to “RoonServer_old”
  • Restart the RoonServer in the WebUI to generate a new Roon database folder
  • On the Roon Remotes, press “Use another Roon Server” and connect to the new database
  • Restore a backup

macOS / Windows / Linux RoonServer

  • Stop RoonServer
  • Navigate to your RoonServer’s Database Location
  • Find the folder that says “RoonServer”
  • Rename the “RoonServer” folder to “RoonServer_old”
  • Reinstall the RoonServer App from our Downloads Page to generate a new RoonServer folder
  • On the Roon Remotes, press “Use another Roon Server” and connect to the new database
  • Restore a backup

About Corruption

Why does corruption happen? 

Generally speaking, corruption is when Roon is trying to read something from the database that it did not write. So a crucial piece of data was altered or is missing, and the alteration didn't happen because of Roon. 

Common causes of corruption include: 
  1. Unstable power situations
    1. i.e. frequent power outages or the use of "smart" plugs that cut power regularly
  2. Failing hardware
    1. Typically bad drives or RAM
  3. Drive where Roon is installed is out of space

How can I prevent corruption?

If you've experienced issues with corruption in the past, we recommend running tests on the drive where Roon is installed and the RAM your device is using. Often times there are failures occurring here and that hardware needs to be replaced in order to ensure a stable experience in the future. 

We also highly recommend using Roon's backup functionality. Having regular backups that go several months means that you always have a safety net in the unfortunate event that your hardware starts failing. 

Need help?

Having trouble with your database loading and you need additional help? Reach out to our support team by opening a support thread on Roon Community