If your Nucleus or ROCK won't start, and you can't open its Web Administration Interface for Nucleus or ROCK, you can try to recover it with the RoonOS installer on a USB flash drive.
The installer offers two options: install from scratch, or recover a previous install of RoonOS. Recovering only rewrites the partition table and the base operating system. Roon Server, your settings, and your databases are kept as they were. This should get you back to the Web Administration Interface, where you can investigate further.
Please choose
Recover, not
Install. Installing from scratch permanently erases all your Roon databases and settings.
If you've just replaced the SSD in a Nucleus or Nucleus+ and you're following the
Nucleus SSD Replacement Guide, please choose
Install instead, because the new SSD is empty.
Before You Begin
- Another computer (Windows, Mac, or Linux) to download the recovery image and write it to a USB flash drive.
- A USB flash drive of at least 1GB. Writing the image erases everything on it.
- A USB keyboard and a monitor or TV connected over HDMI or DisplayPort, so you can use the installer menu.
Download
Please download the recovery image to another computer, not your Nucleus or ROCK. The image you need depends on your device's RoonOS version:
- RoonOS 3.0 (Nucleus One, Nucleus Titan, and ROCK in UEFI mode): download the RoonOS 3.0 recovery image (
roonbox-linuxx64-nuc5-usb-factoryreset.img.gz). Its Recover option works whether your device updated to 3.0 from RoonOS 2.1 or was installed fresh with RoonOS 3.0. - Earlier RoonOS versions (including Nucleus and Nucleus+, and ROCK in legacy BIOS mode): download the earlier recovery image (
roonbox-linuxx64-nuc4-usb-factoryreset.img.gz).
Nucleus and Nucleus+ (Rev A and Rev B): please keep the BIOS in legacy mode, and don't switch it to UEFI. RoonOS 3.0 isn't supported on these models.
Not sure which to use? If your device updated to RoonOS 3.0 by itself, either image works, but we recommend the RoonOS 3.0 image. If RoonOS 3.0 was installed from scratch with a USB drive, for example on a new ROCK or after replacing a ROCK's SSD, you must use the RoonOS 3.0 image. The earlier image can't recover a fresh RoonOS 3.0 install, because it uses a different drive layout.
The downloaded file ends in .img.gz. You don't need to decompress or unzip it.
Writing to a USB flash drive (from a second computer, not the NUC)
Next, write the image to your USB flash drive. You can use Etcher or Rufus, as described below. If you prefer the command line on Linux or macOS, please see Using the Command Line in the ROCK Install Guide.
Option 1: Windows / Mac OS / Linux
- Plug in your USB flash drive.
- Download and install Etcher from the balenaEtcher website.
- Open Etcher.
- Click Flash from file and select the
.img.gz file you downloaded. - Click Select target and choose your USB flash drive.
- Click Flash! and wait for it to finish.
Here's the flashing process in Etcher:
If you have trouble flashing with Etcher, you can also try Rufus on Windows. Here's the flashing process in Rufus:
Running Recovery
- Turn off your Nucleus or ROCK.
- Unplug any USB storage connected to it. You can plug it back in after recovery.
- Connect your USB keyboard and monitor, then insert the USB flash drive you prepared into a USB port.
- Turn on your device and immediately start pressing F10. Keep pressing it until a menu asks which device to boot from.
- Select the USB flash drive and press Enter.
- In the installer, select the Recover option, not Install.
- When recovery finishes, remove the USB flash drive and restart your device. Then check that it starts and that you can open the Web Administration Interface.
A fresh RoonOS 3.0 install uses a different drive layout from RoonOS 2.1, so the earlier image's Recover option can't be used to go back to RoonOS 2.1.
Still can't start your device after recovery? Nucleus owners, please get in touch with our Technical Support team here. ROCK owners, please post in our Technical Support category.