How to Update Nucleus Firmware and Roon Server Software

Updating Nucleus

Once your Nucleus is powered on, please make sure it's completely up to date before moving forward. The steps below walk you through updating your Nucleus firmware and Roon Server software.

Info
RoonOS 3.0 brings a redesigned Web Administration Interface to Nucleus One, Nucleus Titan, and ROCK once 3.0 reaches them. Until then, they run RoonOS 2.1 with the original interface. Nucleus and Nucleus+ (Rev A and Rev B) stay on RoonOS 1.0 and don't receive RoonOS 3.0. To check which you have, please see Which version of the Web UI do I have?

Updating Nucleus Firmware

Please update the firmware when you first set up your Nucleus, and keep it updated as new releases become available.

RoonOS updates also appear in Roon under Settings > About. They're listed as Roon OS followed by the version number, ahead of any Roon updates. You can install them there, or from the Web Administration Interface below.

Update Nucleus Firmware from the Web Administration Interface

  1. In the Roon app, go to Settings > Setup.
  2. Next to Find Roon OS, click Find. A window appears listing all RoonOS devices on your network.
  3. Find your Nucleus and click its IP address. This opens the Nucleus Web Administration Interface.
  4. Update or reinstall the firmware:
    • RoonOS 3.0: on the Overview tab, find the Operating System row. If an update is available, click Update, then confirm in the Update RoonOS? window. If you're already on the latest build, the row shows Up to date and offers Reinstall instead.
    • RoonOS 2.1 or 1.0, including all Nucleus and Nucleus+: click Reinstall under Operating System. This installs the latest available firmware, even if you're already up to date.

This can take several minutes, depending on your internet connection.

Notes
Updating or reinstalling the firmware won't affect your settings or your Roon database.

On RoonOS 3.0

The Overview tab in the RoonOS 3.0 Web Administration Interface, showing the Operating System row with its version, update track, and Reinstall button

Progress stays on screen during an update or reinstall, even if you reload the page. If it fails, the Web Administration Interface explains why, such as how much space is needed versus available. Depending on the failure, your Nucleus either keeps running the version you already had, or Roon is unavailable until a reinstall succeeds. The page tells you which.

The Operating System row also shows your Update track: production for regular releases, or earlyaccess if you've joined the Early Access program. To switch tracks, please see the Roon Early Access Program.

On RoonOS 2.1 or 1.0

The Reinstall button is in the Operating System section of the original Web Administration Interface.

The Operating System section of the original Nucleus Web Administration Interface, showing the Reinstall button

Updating Roon Server

  1. From any device connected to Roon, go to Settings > About.
  2. Available updates are listed for each device. Click the update to install it.
  3. If the update has already been downloaded, you're prompted to relaunch.

If you're already up to date, each device shows "You have the latest version installed." To see what's changed in a release, click Read change log.

The About screen in Roon listing available software updates for connected devices

Update Settings

Roon offers three options for handling updates, and you can set them for each device. To choose one, go to Settings > About, click the gear icon on a device's card, and select an option. The current setting is highlighted.

Info
These options don't appear on mobile remotes.

The three update options in Roon's settings

  • Automatically install all updates: Roon downloads every update as it becomes available. We recommend this option, as it's the best way to stay on the latest version and get new improvements first. Once an update installs, you're prompted to relaunch the app.
  • Automatically install bugfix and other minor updates: Roon installs minor maintenance releases automatically, and asks before any major update downloads. Major updates generally include new features or bigger changes.
  • Ask before downloading any updates: Roon doesn't download updates automatically. When an update is available, a notification lets you choose whether to install it.

Downgrading

Downgrading Roon isn't supported. It can cause database, remote, and cloud compatibility issues. Once your Nucleus is on RoonOS 3.0, you can't reinstall RoonOS 2.1.