Troubleshooting
Roon Server/Roon failing to start after updating to build 1167
There have been a few reports that after updating to Roon and/or RoonServer to build 1167, the Roon Core fails to start with the following error contained in logs: Application Domain: RoonAppliance Assembly Codebase: ...
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 core from the ...
How to set up your Cabasse Pearl device
To use the Roon Tested Cabasse Pearl line of products with Roon, you must add your device as an "accessory" in the Apple iOS "Home" app. Here's how you can do that: Open "Home" app on your iOS device Tap the "+" button Tap "Add Accessory" Tap "More ...
Uploading Roon/RoonServer Database
In some advanced troubleshooting cases, Roon support staff may ask you to upload your Roon Database for further testing. Roon Database in this context refers to your entire RoonServer/Roon folder depending on the install type. To send this to Roon ...
Roon on Windows won't start or crashes right at launch
There are a number of reasons why this might happen, but most frequently we find that this can happen after a Windows update. Sometimes drivers are corrupted or other changes cause Roon to crash. If you're experiencing this type of issue, please try ...
Troubleshooting - "There was an issue loading your database", endless loading at launch, or missing all audio devices
These symptoms typically occur when your Roon database can't be read properly by Roon. First, try giving your Core machine a reboot, many times this will resolve the issue. If that doesn't help, it might be a sign that your database has become ...
Resolving "Metadata Improver: Halted" error messages
If you come across an error message saying Metadata Improver: Halted, please try the following steps to resolve. Update Roon This error can occur if you're running an outdated version of Roon. Please ensure that you're running the latest version. ...
How do I know my devices are on the same subnet/IP range?
What is a subnet? A subnet is a subnetwork, meaning a network within a network! We won't go into the nitty-gritty technical aspects, but ultimately this means that a network is divided into multiple smaller networks on different IP ranges. Roon ...
FAQ: What does DNS mean? How do I change my DNS settings?
What does DNS mean? What does it do? DNS stands for Domain Name System. We won't go into all the technical details here, but DNS plays a vital role in internet communications, and the DNS service you choose can impact the performance of your system. ...
Why are streaming service tracks and albums appearing in my library that I didn't add?
Roon never adds music to your streaming service content on its own — you either have to manually add content to your library in Roon, or favorite something in the streaming service's app. If music appears in Roon that you didn't add, there's a strong ...
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 ...
Reset network settings on RoonOS
If you've set a static IP on a RoonOS Core (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 ...
iOS Permissions
As of iOS 14+, Roon needs permission for Local Network in iOS settings. You should be prompted for this when launching Roon, but if you ever need to adjust these settings after the initial launch you can go to the iOS Settings app, select Roon, and ...
Screen Resolution Is Too Small
Roon requires a resolution of at least 1280x720, and if your scaling factor results in a virtual resolution smaller than that you can see this error when trying to use Roon. This most frequently happens when scaling from high resolutions, like with a ...
MSI Afterburner Compatibility Issues
We've seen reports that the gaming overlay used by MSI Afterburner can result in Roon not starting up properly, with a screen showing text like this: If you're seeing this issue at startup, please disable the gaming overlay when using Roon. To do ...
Android Display Settings
Roon's interface should look great on most common Android devices, but because of the wide variety of Android devices and manufacturers in the world, there's a chance you may run in to a few display anomalies, such as: - Your tablet is displaying the ...
Configuring Windows to log in automatically for Headless Servers
To configure Windows to log in automatically, you'll need to follow these steps: Click Start, and then click Run. In the Open box, type Regedt32.exe, and then press Enter. Locate the HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows ...
Database Location
Remember to ALWAYS exit or stop Roon/RoonServer before copying, moving, or accessing your Roon database. macOS Core Open Finder and click Go in the top bar Hold down the Option key (or Alt)(⌥) to unhide the Library folder Click the Library folder ...
Downgrading
Downgrading between Roon 2.0 and Roon 1.8 is temporarily supported as we transition to Roon 2.0. Please see our 1.8 <-> 2.0 Migration Guide for more details! As a general rule, we do not make older versions of Roon available for download. We also ...
Flags
Command Line Flags Occasionally, Roon Support will need more detailed logs about an issue you're experiencing. In these cases, they may ask you to enable additional logging using something called a command-line flag when you launch Roon. This flag ...
How do I perform a manual backup
We recommend against manual backups. Roon provides a robust built-in backup function that is more flexible and reliable than backing up manually. If you don't have a good reason for backing up manually, we strongly recommend backing up using the ...
KEF Troubleshooting
Often times when we see reports of KEF issues the following troubleshooting steps are useful in narrowing down where exactly the issue lies: * Are the KEF speakers using the 5Ghz WiFi network and not 2.4Ghz? Is there any change if connecting both the ...
Logs
Occasionally, Roon Support will need to have a look at your logs or database. The instructions below will walk you through finding various folders that we might need to look into your issue. In most cases, you'll want to look at the machine running ...
Moving Roon to a new Core
Your Roon database contains your edits, playlists, favorites, play history, login information, and settings. When setting up a new dedicated Core (like a Nucleus), or just moving between Roon and RoonServer, you may want to transfer the database from ...
ROCK Recovery
Users are expected to try to recover their data and/or reinstall using the web UI if their device is unusable. However, if you can't even boot up ROCK and get to the web UI, then doing a recovery via the USB flash drive ROCK installer is an option ...
RoonOS web
What's Possible 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 Roon OS you're running, and reinstall the latest ...
Posting Screenshots on Community
Adding screenshots to support posts is a great way to help the Support Team help you more quickly. To post screenshots to Community please follow these instructions: Create the screenshot If on macOS use these instructions to create the screenshot. ...
Skipped Files
Sometimes Roon encounters a file that looks like it should contain some audio or artwork, but is unable to import that file into your library. You can see a list of files using the "Skipped Files" feature, accessible via Settings: What is the Skipped ...
Troubleshooting Audio Dropouts
Overview This document contains information about tracking down and troubleshooting issues that lead to audio dropouts, in particular with RAAT-based outputs, including RoonReady devices, and outputs connected to computers or devices running Roon, ...
Updating
Roon is always improving, so it's important to keep all your devices updated. This will ensure you have access to the latest features and improvements, whether you're running Roon, RoonServer, or Roon Remote. Updates are always free of charge for our ...
Why can't Roon Remote Connect?
If you’re running Roon in remote mode and having problems connecting, here are some troubleshooting steps to get you going. Additional Troubleshooting Firewall Roon should be able to connect with your firewall enabled, but some users have reported ...
Networking Best Practices
A properly functioning home network ensures that Roon performs as expected, with remotes connecting and loading content quickly as you browse, and audio devices that are free from dropouts and other playback issues. More complex network setups will ...