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. 



    • Related Articles

    • Backup

      Your Roon database is full of information about the music you love. In addition to your library's metadata, it also contains any edits you've made, your play history, all of your Roon playlists, your favorites, your settings, and more. All of this ...

    • Restoring from a Backup

      There are a handful of reasons why you may need to restore your Roon database using a saved Backup. A few common reasons are: You’re moving to a new Roon Server device - Setting up a new server? Restoring a backup transfers all your playlists, tags, ...

    • Database Location

      Remember to ALWAYS exit or stop Roon/RoonServer before copying, moving, or accessing your Roon database. macOS Open Finder and click Go in the top bar Hold down the Option key (or Alt)(⌥) to unhide the Library folder Click the Library folder Find and ...

    • What is a Backup in Roon?

      A Roon backup is a snapshot of your database at a given time. It saves all the ways you’ve customized Roon: Playlists (including those from streaming services and local files) Album and track edits (metadata corrections, artwork changes, merges) ...

    • Troubleshooting Audio Dropouts

      Overview This document contains information about tracking down and troubleshooting issues that lead to audio dropouts, in particular with RAAT-based outputs, including RoonReady devices, and outputs connected to computers or devices running Roon, ...
    Visit the Roon Community!
    Need help? Thousands of Roon subscribers and audio enthusiasts are chatting over on our community site right now, join them! You don't even need a Roon subscription to sign up.