QNAP NAS interrupted update leaving Roon server undetected (ref#7YFG3L)

Hi @Chris_Russell1,

Thank you for your patience, over a month is a long time to be without Roon and I can hear how frustrated you are. Let me address each of your points as clearly as possible.

Step 1: Container is stopped :white_check_mark: Confirmed, no action needed here.

Step 2: Permissions :white_check_mark: Your screenshot shows the Music shared folder with both administrators and ChrisR having Read/Write access. That is correct and no changes are needed here.

Step 3:What folder to rename, and where to create the new one

This step is about creating a clean, dedicated folder for Roon’s application data (its database, settings, etc.) on your NAS. Here is exactly what to do:

  1. Open File Station on your QNAP (you'll find it in the main menu).
  2. Navigate to the homes shared folder, then into your own user folder (likely called ChrisR or admin).
  3. Look for a folder called RoonServer (this is where the old container was storing its data). Rename it to RoonServer_OLD, right-click it and choose Rename.
  4. Still in the same location, click Create Folder and name it exactly: RoonServer
That gives Roon a fresh folder to work with, while safely preserving the old data in RoonServer_OLD in case you need to recover anything from it later.

Step 4: The YAML code and recreating the container

The “YAML code” is the text in the configuration box that looks something like this, it defines how your container is set up:

services:
 roon-server:
 image: steefdebruijn/docker-roonserver:latest
 container_name: roon-server
 network_mode: host
 environment:
 - TZ=Europe/London
 volumes:
 - /share/homes/ChrisR/RoonServer:/var/roon
 - /share/Music:/music
 restart: unless-stopped

To recreate the container using this:

  1. Open Container Station on your QNAP.
  2. Click Create (or the + button).
  3. Choose Create Application (this is the option that accepts YAML).
  4. Paste the code above into the text box. Important: check that the paths match your setup, specifically:
    • /share/homes/ChrisR/RoonServer should be the path to your newly created RoonServer folder. If your username folder is named differently, adjust accordingly.
    • /share/Music should be the path to your Music folder on the NAS (this is where your audio files are stored).
  5. Click Create or Deploy.
If you still have the Docker Configuration Generator open in your browser, look for a button or tab labelled YAML, Compose, or docker-compose, the text in that box is the YAML code. Copy all of it and paste it as above.

Regarding Screen Sharing, Roon Support doesn’t offer screen sharing sessions unfortunatly. However, the good news is that you don’t actually need it, you are clearly following instructions carefully, and the remaining steps are very doable. The key is taking it one screenshot at a time.

What I’d suggest: attempt Step 3 first (renaming the folder in File Station), take a screenshot of the result, and post it. Then we can confirm you’re in the right place before moving on to Step 4. That way nothing goes wrong silently.

One more important thing with finding your backups. Before recreating the container, it’s worth checking whether your old Roon database backup exists.

In File Station, search across all shared folders for a folder called RoonBackups. It may be in the Download share, the homes share, or even on an external drive if one was connected. A screenshot of what you find would help confirm whether your library data is recoverable.

You are not far from the finish line here, the hard work is already done. Let’s take it one step at a time. :+1:

Hi,

I found the back-ups and they are dated April 2026:

I also found the RoonServer folder. This is a screenshot from before I renamed the folder:

I then renamed the folder to ‘OLD’ and created a new ‘RoonServer’ folder:

So I think I have completed step 3. Can you confirm that this all looks in order please?

Also, I now understand how to copy the YAML code. There is a ‘copy to clipboard’ button in the top-right corner:

Are you happy for me to proceed to steps 4 and 5 now?

Thanks again for your advice on this!

Hey @Chris_Russell1,

Thanks for the follow-up! Everything is looking good, I would continue with steps 4 and 5 now as you have mentioned. :+1:

Hi,

I have completed Step 4, up to and including Step 4.5 (Click Create). The application is running:

However, following the instructions from this link (https://help.roonlabs.com/portal/en/kb/articles/installing-roonserver-on-qnap-with-docker#Step_6_Connect_from_Roon_Remote), I’m not sure how to ‘stop the native QNAP application via the App Store’ (Step 6, first bullet on the instructions on the above link). I assume that the “App Store” refers to the App Centre. Is this correct?

The App Centre looks like this:

I can’t see an icon for the native QNAP app. Can you identify it from the above screen shot please and let me know where to find it and how to stop it?

Finally, if I open Roon on my laptop (without having stopped the native QNAP app), the opening screen looks like this:

As you will see, there isn’t an option for ‘Select a different server’, as per the instructions linked above. Can you provide instructions for how to proceed from this screen, once I have stopped the native QNAP app please?

Thanks.

P.S. Re the above screenshot of the Roon opening page, MusicNASRoon is my old server. I named the new one roon-server.

Should look like this, the marked app in App Center:

You can either stop this one manually, or deinstall it, if you see it under your apps.

The screenshot shows already the page for “select a different server”, and if this “MusicNASRoon” is the QNAP machine, you have Roon 2.66 running, which indicates your Roon in Container is set up and running properly, just under the old server name. In this case, you don´t have to stop or deinstall RoonOnNas.

What happens if you click on “Connect” and login to your roon account?

Hi,

The QNAP App Centre doesn’t appear to have a Roon app icon. I think I may have removed it when following your instructions the first time around. Nevertheless, you have confirmed that my Roon Container us running propoerly under the old server name and that I don’t have to stop or deinstall Roon on the NAS.

When I open Roon, press Connect and log in, I get this page:

I believe the Music folder that is shown is the folder where my music is stored. Should I press continue? If so, what will I need to do from there?

It feels like I’m getting close!

If the second path of your docker installation, called /Music, which points to the music files, is set correctly, you can just continue, and roon will find your local files and start scanning them.

f you have a backup from previous installations, and want playlists, library edits and alike to be restored, you might want to disable the file folder for now and restore the backup first. To do so, you need to copy all the subfolders plus the file called _roon_backup_root_ from your pervious location /Multimedia/Roon-Backups as a whole to the new one:

/Container/roon-backups

Subsequently you can open roon remote and find the old backup via Settings > Library > Find Backup - you might have to search for the new Roon-Backup folder, because Roon in the container sees all the folders being shared with the container.

Good Luck, you are very close!

Yes, I’d like to retain my playlists, library edits etc. However, I’m not sure how to disable the file folder. Which file folder do you mean? Do I find it in File Station? How do I disable it please?

I can see the Roon back up folders and files in \Multimedia/RoonBackups (see below) and I will copy and paste them into the /Container/roon-backups folder (see below):

Once I’ve copied and pasted the back up files and folders, how do I get to settings in Roon? Do I simply press continue on the opening screen (below)?

If so, will this take me to the home page of Roon, where I can select settings > Library > Find Back up? From there, am I looking for a folder entitled roon-backups (lower case) rather than RoonBackups (the old back up folder)? And do I just press back-up? Will this restore my original library and take me to the Roon home page?

You mentioned disabling the file folder. Does this need to be re-enabled after the back up has been restored? If so, how do I do this please?