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 will generate additional information about your specific issue, which will appear in your logs to help our support team diagnose the problem. In most cases, you'll want to look at the machine running your server, although sometimes Roon Support will ask you to send logs from a remote installation as well.

Remember to ALWAYS shut down Roon on whatever device you're getting logs from before copying, moving, or accessing your Roon database. 

Capturing logs using a command-line flag

To create logs with a particular flag, follow these steps:
  1. Start Roon with the appropriate flag, as detailed below
  2. Run Roon until the problem you are experiencing occurs
  3. Stop Roon
  4. Collect and upload logs as shown here: logs
  5.  If your system is running Windows or Linux, remember to go back and remove the flag from the shortcut or startup script

Starting Roon with a command-line flag

Follow the instructions below for the operating system on which Roon Support has asked for logs.


  1. Right-click the Roon icon and select “properties” from the drop-down menu
  2. You will see a field titled “target”. Place '-storagetrace' or whatever other flag has been requested at the end of the “target’ input field
  3. Make sure the “start in” input field ends with “application folder” and nothing else
  4. Start Roon by double-clicking on the shortcut
  5. After uploading the logs for Roon Support, remember to go back and remove the flag from your shortcut
Here's an example image:


  1. Launch the "Terminal"
    1. Click the "Magnifying Glass" icon in the top right-hand corner of the screen top open the search function, then type in "Terminal"
    2. Double click on the "Terminal" top hit, highlighted in blue here: 

      2. Once launched, the terminal will appear to be blank (excluding your username) and this is where you will want to enter the following command:

/Applications/Roon.app/Contents/MacOS/Roon -storagetrace` Replace `-storagetrace with whatever flag Roon Support has requested


  1.  Find and open the RoonAppliance startup script. This file is /opt/RoonServer/Appliance/RoonAppliance by default, but individual Linux installations may vary
  2. Add the flag to the end of the last line in the script, giving something like exec "$HARDLINK" --debug --gc=sgen --server "$SCRIPT.exe" "$@" -storagetrace
  3. Restart RoonServer. To do this, open a terminal and type `sudo pkill start.sh` You will be prompted for your password, type it in and then press enter, then wait for RoonServer to be restarted.
  4. After uploading the logs for Roon Support, remember to go back and remove the flag from the script and restart RoonServer again.


  1. Find the ROCK network folder by following the instructions in the "Method #2: Importing To Network Folder" section here
  2. Create a text file in that directory with the following name (all one word, no caps, no extension): roonserverargs 
  3. Inside that file, add one line with only the flags requested by Roon Support, separated by spaces. For example: -storagetrace -watchertrace
  4. Restart RoonServer in the ROCK web interface: type "ROCK" into the address bar in any web browser, then click the "restart" button under "Roon Server Software"
  5. After uploading the logs for Roon Support, remember to go back and delete the roonserverargs file.

    • Related Articles

    • Editing and Grooming Your Collection

      Even prior to our launch in May '15, it was clear Roon needed to do much more to meet the needs of users who want to exert control over how metadata is displayed and experienced in the app. At launch, Roon was focused on the user who wants their ...
    • Metadata Model

      Introduction This document is meant to serve as a technical reference to Roon's metadata model. Roon models your metadata in an object graph. This means that there are a set of objects--such as albums, tracks, performers, performances, compositions, ...
    • FAQ: Why did all my zones disappear?

      If your zones are not showing up in Roon, or all of your audio outputs are gone, it typically indicates: A networking problem is interfering with Roon's ability to communicate with your zones. Review our network best practices for tips on ensuring ...
    • FAQ: Where can I set a crossfade?

      How To Configure Crossfade You can set a crossfade of 0-10 seconds from the Zone Picker. Click the current zone on the right side of the bottom bar, then in the pop-up window click the speaker icon followed by the gearwheels icon to display the Zone ...
    • File Tag Best Practice

      Achieving Great Results From File Tagging Roon and file tags Roon has always read a significant amount of information from your file tags. Along with track timings, Roon uses tag information, such as your album and track titles, artist names, unique ...
    Visit the Roon Community!
    Need help? Thousands of Roon subscribers and audio enthusiasts are chatting over on our community site right now, join them! You don't even need a Roon subscription to sign up.