Issue-Specific Guides
Reset Roon Database on Mac/Windows
You may sometimes need to refresh the Roon Remote App database (not Roon Server) on your Windows or Mac PC. To do so, you can follow the below instructions: Create a Backup of your current database (if possible/Roon is accessible) Exit out of ...
Roon with Antivirus Software
With any third-party security software, ensuring Roon has proper access to communicate with the other devices in your local setup is important. Below we'll share a handful of popular antivirus options with links on how to manually add Roon as an ...
Accessing the Roon Database on sonicTransporter
There are typically two reasons why users need to access their Roon Database on a sonicTransporter: To create a backup of the database To move/migrate a database from an existing Roon Server In this article, we’ll cover how to do this. Expose the ...
On-Screen Keyboard For Windows Touchscreen Laptops
On some newer versions of Windows devices, there is an issue with finding the On-Screen Keyboard option in Roon Settings. Below is a workaround for getting the On-Screen Keyboard to properly appear in Roon. To enable the On-Screen Keyboard: 1. Head ...
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 ...
Airplay Issues in Roon
When attempting to start playback on certain devices using AirPlay, Roon may receive an error. Below, we'll delve into the devices that are known to experience these issues and provide some helpful solutions to address them. Cabassee Pearl & JBL ...
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 server 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. You ...
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 ...
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 ...
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
For those signing on with a PIN, this will disable the PIN login method and automatically log you in using your Microsoft account credentials supplied in these strings. To configure Windows to log in automatically, you'll need to follow these steps: ...
Database Location
Remember to ALWAYS exit or stop Roon/RoonServer before copying, moving, or accessing your Roon database. macOS 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 Find and ...
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
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 ...
Moving Roon to a new Server
Your Roon database contains your edits, playlists, favorites, play history, login information, and settings. When setting up a new dedicated server (like a Nucleus), or just moving between Roon and Roon Server, you may want to transfer the database ...
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 app (mobile.) Updates are always free of charge ...