# Migration --- Your Roon database contains your edits, playlists, favorites, play history, login information, and settings. When setting up a new dedicated [[Core|Architecture]] (like a Nucleus or a [[ROCK]]+NUC machine), or just moving between Roon and RoonServer, you may want to transfer the database from old to new. This will work regardless of what platform your Core was previously running on -- your database will work on any platform that supports running a Core. ## Preparation Before you start, confirm you're running the latest version of Roon on both the new and the old Core. You can check this by clicking *About* on the *Settings* page. It is mandatory that both are fully updated. Also, on your old Core, please confirm that the import process has completed. You can monitor this process by clicking the spinner in the top-right. If you don't have a spinner here, you are done importing. > <img src="https://roon-community-uploads.s3.amazonaws.com/original/3X/2/6/265a2a545830b40eeb048b54671f041175117cdb.png" width="300" height="95"> ## Migrating ### Step 1: Backup Your Database In order to migrate Roon database to a new machine, the first step is to backup your database. To do this, we strongly recommend you connect a USB drive directly to your existing Core, or use a NAS or other network storage device on your local network. ##### _**Note** - While Dropbox is a good way to keep an incremental backup in the cloud, we don't recommend it for this migration, as you will be transferring an entire copy of your database, and Dropbox will be significantly slower than USB or network storage._ <br> #### If you already have a scheduled backup: 1. Go to the "`Backup`" tab of Settings 1. Click "`Scheduled Backups`" 1. Click the "three dots" and select "`Force Backup Now`" 1. When the backup completes you should see _"Last Successful Backup"_ at the bottom of the Window <img src='http://roon-kb.s3.amazonaws.com/ded60fe9-6c7e-47f6-b73a-697bdace368c.png'/> <br> #### If you would like to create a new backup: 1. Go to the "`Backup`" tab of Settings 1. Click the "`Backup`" button next to Backup Now 1. When the backup completes you should see _"Last Successful Backup"_ at the bottom of the Window <img src='http://roon-kb.s3.amazonaws.com/494a418e-711d-42af-8610-282d68c86f4d.png'/> <br> ### Step 2: Restore Your Database Now that your Roon database is fully backed up, it's time to restore it to your new Core. - Make the backup accessible to the new Core - If you backed up to a USB drive, connect it now to the new Core - If you backed up to network storage, ensure you know the address, log in, and password for your NAS or network storage device - Connect to the new Roon Core - Start your new Roon Core - After your new Roon Core is running, launch Roon on your Mac, Windows PC, iPad, or Android Tablet. <br>_**Note** - We don't recommend using smaller Android tablets or phones for this process._ - Since this is your first time launching your new Core, you will be asked to log-in. Instead of logging in, click "Restore A Backup" in the lower-left hand corner <img src='http://roon-kb.s3.amazonaws.com/ba59c26d-1529-42e5-b5a2-e26ffd6a49e5.png'/> - Use Roon's file browser to locate the `RoonBackups` folder you created in Step 1 - If you created a USB backup, it should be connected to your Roon Core and you can navigate to it - If you backed up to network storage, you can find the `RoonBackups` folder by clicking _Add Network Share_ and entering the details for your NAS - Read on to make sure your Storage settings, Audio settings, and other configuration details are updated properly ### Step 3: Configuration There are a few other considerations once your database has been restored, in order to get everything back to normal. ## Storage Networked storage devices (like a shared folder on a NAS) will work without any further changes after restoring. For other storage, you will need to edit your current storage settings so that Roon can find this music at a different location. Please follow [this guide](https://kb.roonlabs.com/FAQ:_How_do_I_move_my_collection_to_a_new_folder%2C_hard_drive_or_NAS%2C_Will_I_lose_my_edits%3F) to do this in a manner that won't cause your edits/favorites/play history to be lost. ## Audio Network audio devices (such as RoonReady devices, RoonBridge, Squeezebox, HQPlayer, etc) will work without any further changes after restoring. If you previously had an audio device directly connected to the machine running your Core, you can connect that device to your new Core and configure it as normal. If you'd prefer to keep the audio device connected to the machine that was previously running your Core, you can also install [[RoonBridge]] on that machine in order to make it accessible over your network. ## Previous Roon Core Once your new Core machine is up and running, you can continue running Roon as a remote on the machine that previously ran your Core. **It is important that you "clean up" the machine that was previously running your database. You do not want the same database running on two machines.** We recommend renaming or deleting the Roon database folder on the machine that previously ran your Core. You can find the [[Roon database folder here|Database Location]]. **Please make sure you have a backup of your database before deleting it**. --------- If you have any issues with this process or need more assistance, please [[let us know|Contact]]. Thanks!
Page last changed Tue Oct 30 2018