Migrating to Nucleus

Nucleus Migration Guide (Nucleus/Nucleus+ Rev A | Nucleus/Nucleus+ Rev B | Nucleus One | Nucleus Titan)

If you're setting up Nucleus, and your Roon Server had previously been running on Mac, Windows, or Linux, you'll need to migrate your Roon database. Your database includes your playlists, edits, play history, tags, settings, and more. This guide will walk you through the process.

Step 1: Backup Your Database

In order to migrate to Nucleus, the first step is to backup your database. To do this, we strongly recommend you connect a USB drive directly to your existing Roon Server, or use a NAS or other network storage device on your local network.

Alert
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)

If you already have a scheduled backup

  1. If you've already scheduled Roon to backup to local or network storage, go to the Backup tab of Settings
  2. Click Scheduled Backup
  3. Click the "three dots" and select "Force Backup Now"
  4. When the backup completes you should see "Last Successful Backup" at the bottom of the Window
  5. Shut down your Roon Server

If you would like to create a new backup

  1. Go to the Backup tab of Settings
  2. Click the "Backup" button next to Backup Now
  3. When the backup completes you should see "Last Successful Backup" at the bottom of the Window
  4. Shut down your Roon Server

Step 2: Restore Your Database

Now that your Roon database is fully backed up, it's time to copy it to Nucleus.  To Restore Your Roon Database To Nucleus:
  1. Ensure the backup you created above is accessible to Nucleus
    1. If you backed up to a USB drive, connect it to Nucleus (recommended)
    2. If you backed up to network storage, ensure you know the address, log in, and password for your NAS or network storage device
  2. Connect to Nucleus by launching Roon on any Mac, Windows PC, iPad, or Android tablet and selecting Nucleus from the "Choose Your Roon Server" screen
Alert
We don't recommend using an iPhone or Android phone for this process.
  1. Since this is your first time launching Nucleus, you will be asked to log-in when you connect. Instead of logging in, click "Restore A Backup" in the lower part of the screen. You will be able to log in after choosing "Restore a Backup".

  1. Use Roon's file browser to locate the `/RoonBackups` folder you created in Step 1
    1. If you created a USB backup, it should be connected to your Nucleus and you can navigate to it
    2. 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

Step 3: Configuration

There are a few other considerations once your database has been restored to Nucleus. 

Storage

In some cases you will need to re-configure Roon to find your storage devices. It is important that the proper steps are followed when migrating your media library to ensure that your edits and plays are not lost. 

USB Storage

If you're using the same USB storage as your previous setup, you may need to update the path. Make sure that you *edit* the existing path if needed. Adding a new storage configuration without removing the old configuration can cause file identification issues.

NAS Storage

If your previous storage location was being accessed over the network, no changes should be required.

Internal Storage

If you're moving your library to the internal storage of Nucleus there are some additional steps that need to be taken to ensure that you library properly migrates with all edits in place. If you need help formatting your internal storage, please see our article on the subject. 
  1. Go to Settings > Storage and disable all current watched folders *except* Internal Storage. To do this, select the 3 dots next to the storage location and then choose Disable.
  2. Access the Web Administration Interface and stop the Roon Server Software. 
  3. Copy your files to the internal storage of Nucleus. 
  4. Once the transfer is complete, return to the Web Administration Interface and restart the Roon Server Software.
  5. Roon will go through the process of identifying the files from your Internal Storage and match them to your existing Roon library. 

Audio

Network audio devices (such as RoonReady devices, Roon Bridge, Squeezebox, HQPlayer, etc) should work without any further changes after restoring. If you previously had an audio device directly connected to the machine running your Roon Server, you can connect that device to Nucleus and configure it like normal. If you'd prefer to keep the audio device connected to the machine that was previously running your Roon Server, you can also install Roon Bridge on that machine in order to make it accessible to Nucleus over your network. 

Subscription

Your Roon subscription can easily be transferred between devices. If you need to log in after restoring your backup to Nucleus, your subscription should automatically be transferred over, or you will be prompted to move it over. FAQ: Moving Your Roon License to a New Server. Authorization Flows covers in detail this process.

Previous Roon Server Machine

Once Nucleus is up and running, you may want to continue running Roon as a remote on the Windows or macOS machine that previously ran your Roon Server. In that case, we recommend renaming or deleting the Roon database folder on that machine. You can find the Roon database folder here.

Warning
Please make sure you have a backup of your database before deleting it

    • Related Articles

    • Nucleus Manual

      Introduction What is Nucleus? At the heart of every Roon system is a Roon Server. This is the brain behind the entire Roon experience – it manages your music collection, streams to your audio devices, and stores the Roon database. The Roon team ...

    • Nucleus Internal Storage

      Your Nucleus supports an internal 2.5" HDD or SSD to create a self-contained music server. For a completely silent system, we recommend using an SSD. If you chose to use an SSD here, the system will stay fully silent. The entire internal storage ...

    • Do I have Nucleus Rev A or Nucleus Rev B?

      What are the different versions of Nucleus? There are two iterations of Nucleus, which we refer to as the revisions of Nucleus, or “Rev A” and “Rev B” for short. These are not separate generations of Nucleus – in fact, most of the internals held ...

    • How to Install a Hard Drive in Nucleus Titan

      Before starting this process, safely stop Roon Server from running, and power down your Nucleus. To install a hard drive for internal music storage in your Nucleus Titan, please follow these steps: 1. Unscrew the bottom lid of the unit: 2. Unscrew ...

    • Nucleus RAM Replacement Guide (All Models)

      Thinking about replacing or upgrading the RAM in your Nucleus device? The process depends on your device generation and warranty status, so please read this guide carefully before proceeding. Nucleus Generations There are three generations of Nucleus ...
    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.