RoonOS Reinstall Directory

Overview

The Reinstall directory is used to pass instructions to the update mechanism to allow a user to make a manual move to a different version of Roon or RoonOS on Nucleus and ROCK devices. This is most commonly used for moving a server from the production branch to a special branch used for testing of new features or bugfixes. This is also the mechanism by which one can migrate a RoonOS device from Roon 2.0 to Roon 1.8 Legacy.

If you need to use this mechanism you will receive instructions from a member of Roon staff or a help center article that includes a link to download an instruction file. When this file is copied into the Reinstall directory RoonOS will use it to determine which version or Roon or RoonOS to install. 

Using the Reinstall Directory

When moving between branches or versions the following steps will need to be executed:

1. Download the instruction file from the link provided and save it on your computer. Do not modify the name, extension, or content of this file.

2. Navigate to the /Data/Reinstall directory on your Nucleus / ROCK.

3. Copy the instruction file that you downloaded into the Reinstall directory.
4. Visit the RoonOS admin page and click on the “Reinstall” button.

The instruction file will be deleted after the installation process is completed. Once on a particular track or version you will continue to receive updates from that track without any intervention. This includes future use of the Reinstall function.

Reinstall Folder “Misconfigured” Error

If you receive an error message when executing a Reinstall via the admin page which states that “your Reinstall Folder is “Misconfigured,” then there is a conflict with the instruction files and the installer doesn’t know what to do. 

This is most commonly encountered when there are two or more instruction files present for the same product. For instance if you have instruction files for Roon 2.0 (production) and Roon 1.8 Legacy (production1x) in the Reinstall folder you will receive this error.

To correct this fault you must ensure that you have one (and only one) instruction file present for Roon and/or RoonOS when performing the Reinstall.

• Related Articles

• Roon OS CDROM

  Overview Starting with RoonOS Build 175, CD audio extraction support is included: Roon OS will "rip" CDs. Further stability improvements of this feature have been recently released with RoonOS (Operating System) Build 254.  You can verify which ...

• Reset network settings on RoonOS

  If you've set a static IP on a RoonOS Server (ROCK/Nucleus) that is no longer accessible on your network you can resolve this by resetting the network settings on your device. You can do so by following these instructions: Connect the Nucleus to a ...

• RoonOS web

  What functions can I perform from the Roon OS user interface? Any device that runs Roon OS includes a web-based administration tool, where you can: Reboot or power off your Roon OS device Confirm your device's Serial Number Confirm what version of ...

• Trouble connecting to ROCK / Nucleus data folder from Windows

  For general instructions for connecting to Roon OS / Nucleus data folders, see these articles:  Roon OS Data Directory Nucleus Internal Storage If you're having trouble accessing the directory from File Explorer on Windows despite trying the changes ...

• Roon OS Data Directory

  Roon OS automatically exposes a shared network folder (SMB share) called `/Data`. Be careful modifying files or folders in this directory, as this could lead to permanent data corruption and/or loss. Some reasons you might want to access the shared ...