Roon OS Data Directory

Roon OS Data Directory

RoonOS automatically shares a network folder (SMB share) called Data. You can use it to reach your storage, copy music, and find files our Technical Support team may ask for.

Warning
Please be careful when you change files or folders in the Data share. Changing the wrong files can permanently corrupt or erase your data.

You might use the Data share to:

  • Access internal or USB storage connected to your RoonOS device.
  • Copy music to internal or USB storage.
  • Add codecs, if the Web Administration Interface reports that they're missing.
  • Access or replace Roon's database.
  • Find log files.

Accessing RoonOS's Data Directory

You can open the Data share from any computer on the same network as your RoonOS device:

  • Windows: in File Explorer, type \\ROCK into the address bar, then open the Data folder.
  • macOS: in Finder, click Go > Connect to Server. Enter smb://ROCK and click Connect. If you're asked how to connect, choose Guest, then open the Data share.

These examples use ROCK. For other RoonOS devices, please replace ROCK with your device's name:

  • Nucleus One: NUCLEUSONE
  • Nucleus Titan: NUCLEUSTITAN
  • Nucleus: NUCLEUS
  • Nucleus+: NUCLEUSPLUS

If the name doesn't work on your network, please use your device's IP address instead, for example \\<ip-address>\Data.

Signing in to the Data share

Guest access is on by default, so you don't need to enter anything. If a device asks you to sign in anyway, please choose Guest on a Mac, or enter guest as both the username and password.

On RoonOS 3.0, if Username and password is turned on in File Sharing, please sign in as roon. The password is roon unless you've set your own.

On Windows, please disconnect any mapped drive to your device before you connect again as Guest, with a different username, or with a new password. Windows only allows one username per server at a time, so an old connection can cause error 1219.

Accessing the Data share over Tailscale isn't supported yet.

File Sharing Settings

On Nucleus One, Nucleus Titan, and ROCK running RoonOS 3.0, you can choose who can connect to the Data share. You'll find these options in the Web Administration Interface under Network & Access > File Sharing. For help opening it, please see the guide for ROCK or Nucleus.

Under Who can connect:

  • Guest (on by default): anyone on your local network can open the Data share without signing in, just like on earlier versions of RoonOS. Some devices can only connect this way.
  • Username and password (off by default): devices sign in as roon. The password is roon unless you've set your own. Turning this on closes Guest to new connections. Devices already connected stay connected, but a device that can only connect as Guest loses access the next time it reconnects.

Below that, Allow older devices (SMB 1) is off by default. Please only turn it on if an older device can't connect any other way, because SMB 1 is less secure.

You can change these settings from your local network until your device is signed in to Tailscale. After that, please use the HTTPS Tailscale page shown in the Changing these settings box. Signing in to Tailscale, or switching Tailscale accounts, removes a share password that was set from your local network, and the share goes back to guest access.

Your File Sharing settings are kept after reboots, updates, and reinstalls. A reset from the Settings tab clears them, along with the share password.

Nucleus and Nucleus+ (Rev A and Rev B), and ROCK installed in legacy BIOS mode, don't receive RoonOS 3.0. Nucleus One, Nucleus Titan, and ROCK in UEFI mode get these settings once RoonOS 3.0 reaches them.

Notes
Can't connect to the Data share? Please check your File Sharing settings. If Username and password is turned on, sign in as roon with your share password. If you're connecting from an older device, it may need Allow older devices (SMB 1) turned on.

Using Roon's Data Directory

Accessing Storage and Importing Music

If your RoonOS device has an internal music drive or a connected USB drive, you can reach it through the Data share. All your connected storage appears in the Storage folder. RoonOS names each folder after the drive's volume name, model, or serial number.

To import music, open the Storage folder, find the drive you want to use, and copy your music to it. Then set up Roon to watch it by following these instructions. You can also use the Storage folder as a small NAS for files Roon doesn't watch.

Notes
You can't store music on the RoonOS system drive. Please use an internal music drive or a USB drive.

If your device has internal storage or a connected USB drive, you'll see a folder for it in the Storage folder:

The Storage folder in the Data share, showing a folder for a connected USB drive

If your Storage folder is empty, your device doesn't have any music storage connected. If you think something is wrong, please get in touch with our Technical Support team here.

On RoonOS 3.0, system files, such as the update state and the Tailscale key, are hidden from the Data share.

Accessing Internal Storage via Local Network

To open your internal music drive directly, please enter the address for your device:

Windows (in the File Explorer address bar):

  • ROCK: \\ROCK\Data\Storage\InternalStorage
  • Nucleus One: \\NUCLEUSONE\Data\Storage\InternalStorage
  • Nucleus Titan: \\NUCLEUSTITAN\Data\Storage\InternalStorage
  • Nucleus: \\NUCLEUS\Data\Storage\InternalStorage
  • Nucleus+: \\NUCLEUSPLUS\Data\Storage\InternalStorage

Mac (in Finder, press Command + K):

  • ROCK: smb://ROCK/Data/Storage/InternalStorage
  • Nucleus One: smb://NUCLEUSONE/Data/Storage/InternalStorage
  • Nucleus Titan: smb://NUCLEUSTITAN/Data/Storage/InternalStorage
  • Nucleus: smb://NUCLEUS/Data/Storage/InternalStorage
  • Nucleus+: smb://NUCLEUSPLUS/Data/Storage/InternalStorage

For more about Nucleus storage, please see Copy Music to the Drive.

Adding Codecs

If the Web Administration Interface on your ROCK reports missing codecs, please place the ffmpeg file in the Codecs folder of the Data share. For steps, please see Missing Codecs.

Accessing Logs

You can find your Roon Server logs in the Data share, in the Logs folder inside the RoonServer folder. If our Technical Support team asks for your logs, please follow these instructions.

Accessing Roon's Database

To move your Roon library to a RoonOS device, we recommend Roon's backup feature. The Data share also gives you access to Roon's database, in the RoonServer folder.

Warning
Please don't change the database in the RoonServer folder unless you know exactly what you're doing. You could lose your library data.

Before you access or copy the database, please stop Roon Server in the Web Administration Interface:

  • RoonOS 3.0: on the Overview tab, click Stop in the Roon Server row.
  • Earlier RoonOS versions: find Roon Server Software, click the arrow next to Restart, then click Stop.

For help opening the Web Administration Interface, please see the guide for ROCK or Nucleus.


Still can't connect to the Data share after these steps? Please get in touch with our Technical Support team here.