Troubleshooting - "There was an issue loading your database", endless loading at launch, or missing all audio devices

Troubleshooting - "There was an issue loading your database", endless loading at launch, or missing all audio devices

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

    • 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 ...

    • 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, ...

    • FAQ: What audio outputs or devices are supported by Roon?

      Connected Outputs: Built-in outputs, USB DACs, and Sound Cards Any audio devices recognized by the OS running Roon or Roon Server will be recognized by Roon, from Built-in Sound to PCI Soundcards to USB DACs. In the settings of Roon under the Audio ...

    • Networking Best Practices

      A properly functioning home network ensures that Roon performs as expected, with remotes connecting and loading content quickly as you browse, and audio devices that are free from dropouts and other playback issues. More complex network setups will ...

    • Audio Setup Basics

      Accessing Audio Settings To access audio settings, click the settings cogwheel from the navigation bar, then choose the Audio tab. Inside the Audio tab, you'll be presented with a list of audio output devices, grouped by type, and in some cases, by ...
    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.