Roon Backups

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 information is stored in your Roon Database. This database is designed to be extremely resilient but catastrophic events like failing hard drives, power cuts, or other unexpected disturbances can corrupt your database. In rare cases, corrupt databases can be unrecoverable, so it's important you backup regularly to avoid losing data.


Important: Your Roon Database is not the same thing as your music library (your collection of music albums and tracks contained in your Watched Folders). It is a separate database that is maintained by Roon. 
We strongly recommend that you do not set the location of Database Backups to be within any Watched Folders because Roon will try to scan that directory and scan the Database Backup itself. This can cause issues, so please keep the locations separate.

How do Roon backups work?

Automatic backup functionality of your Roon Database is built right into Roon! The best way to keep your Roon database safe is to set up a Scheduled Backup. Once you've configured a Scheduled Backup, Roon will automatically run your backup on the schedule you've set. Each backup will only save changes since the last backup.

We recommend configuring Scheduled Backups to more than one location. For example, backup to your NAS and Dropbox, or to a local hard drive and your NAS. 

Roon will create a folder called `RoonBackups` wherever you choose to backup to, and you can later select this folder to restore your backup. Because your database is constantly being updated in the background using applications like Time Capsule, CrashPlan, etc. on your live database is strongly discouraged, and can result in corrupt backups.  

Scheduled backups

To configure backups in Roon, start by visiting the Backup tab of Settings. In most cases you'll want to configure a Scheduled Backup, so you can set it once and not worry about it. Start by clicking View next to Scheduled Backups.






Click Add, and follow the instructions to set up your Scheduled Backups. You'll need to choose a few options, like how often you want Roon to backup and when you want Roon to backup. Roon will be temporarily unavailable while the "snapshot" of your library is created, so make sure to schedule the backups for a time you're rarely listening to music, like the middle of the night. If music is playing when your backup is scheduled to kick off, Roon will retry the next day. Once your backup is configured, you'll be able to see it on the Scheduled Backups screen. Click the "3 dots" menu to make changes to your backup, restore from your backup, or to kick off a backup immediately.


On-demand backups

If you don't want backups to run automatically, you can also run a backup at any time by clicking Backup Now, on the Backup tab in Settings. You can back up to the same location later, and Roon will only save the changes since the last backup. Later, you can restore any of the backups you have saved to that folder.

Restoring Backups 

Restoring a backup will permanently overwrite the current database.
If need to restore a backup to a fresh install of Roon (like if you're moving your Core to a new device, or if you're restoring after a hard drive failure), you can do so from the Login screen. This will work on any Roon Core that is not logged in.



Scheduled Backups can be restored by clicking Clean/Restore from the Scheduled Backups window.




Other Backups can be restored by clicking Find Backups and pointing Roon at your RoonBackups folder. 

We do not recommend restoring a backup directly from Dropbox. The Dropbox API has some limitations in speed which can cause this process to take a very long time, and so it is best to download the backup from Dropbox to a USB drive


Other backup applications

Because the Roon database is frequently being updated in the background with new metadata, cover art, artist information, and more, backing up your "live" Roon database using external programs can result in corrupt backups. We strongly recommend against using Time Machine, Crashplan, Backblaze, or other backup applications to backup your "live" Roon database. If you would like to use any of these applications to back up Roon, set up a Scheduled Backup and tell your backup program to backup the `RoonBackups` folder.

    • Related Articles

    • Database Location

       Remember to ALWAYS shut down your Roon Core before copying, moving, or accessing your Roon database. macOS Core 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 ...
    • How do I perform a manual backup

      We recommend against manual backups. Roon provides a robust built-in backup function that is more flexible and reliable than backing up manually. If you don't have a good reason for backing up manually, we strongly recommend backing up using the ...
    • FAQ: How do I move my Roon library to a new computer?

      Roon tracks every file in your library, and any actions you take in Roon are attached to that file, whether you're editing it, adding it to a playlist, marking it as a favorite, or tracking how many times you've played it. Starting with Roon 1.1 ...
    • Why are streaming service tracks and albums appearing in my library that I didn't add?

      Roon does not add any streaming service content on its own — You either have to manually add content to your library in Roon, or favorite something in the service's app. In the past when we’ve seen this happen it is because the account in question ...
    • What's the difference between albums in my library and albums outside of my library?

      Benefits of adding albums to your Roon library  Adding albums from TIDAL or Qobuz to Roon allow you to take full control of the powerful tools available in Roon. Once an album is added in Roon you can: Add the album or tracks from the album to tags ...
    Ask the Roon Community
    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.



    Something you can't find?
    If you're still stuck, don't hesitate to let us know and we'll get back to you as soon as we can.