How to: Install Roon Extension Manager on QNAP

We are not there yet, the command has to be entered from outside the container. I expect that you use a laptop or PC to connect to the web interface of the NAS. Use that device and try to follow the steps in the instructions I linked to. You have to find the IP address of you NAS, (you might already use this to access the web interface) and use that to connect.

Let me know how far you get.


Thx for the live support! Will do that now.

Here’s what Terminal on my MBP shows after following the instructions:

The 2nd line “roon-extension-manager-1” was the response I received after I entered the first line: “docker update --restart unless-stopped roon-extension-manager-1”. (“roon-extension-manager-1” is the name of the container). I’ll now resart the container.

Here’s what it now shows in the QNAP GUI:

Should I delete the same command int the “console” part of the GUI? I don’t know what that does. Thx.

That’s exactly what we need, now we know the command was understood!
Everything should be fine now.

Better to remove it, it might lead to confusion in the future.

Thank you for confirming! The only way for me to delete the command in the console is to remove the container, reinstall, etc. That should be easily done now that I have the steps! Once I’m done I’ll post the steps for others.

Installing Roon Extension Manager on QNAP: For Novices Like Me!

Thx to @Jan_Koudijs, @BlackJack, and @anon55914447 for help along the way, including instructions (many of which are copied below).

Step 1: Use the App Center in your QNAP to find and install ContainerStation:

The How To:

  1. If you haven’t already, go ahead and install Container Station from QNAP’s AppCenter.
  2. Open Container Station and on the left hand side in the Management tab, click Create
  3. In the search box, type “theappgineer/roon-extension-manager:latest” and you’ll see this:

You’ll also see a list of others. Select the first one “Roon Extension for managing Roon Extensions”.
4. Click Create.
5. Now we’ll get a pop-up where we need to do our first bit of config. Click on Advanced Settings and navigate to the Network tab.
6. Change the Network Mode dropdown to Host. That’s all the config we need to do here so go ahead and click Create again. After you have done that we’ll have a Docker container running a vanilla and very stripped down Linux ready to go!
After a few seconds a background task will complete and your container is now running. Head back to the Container Station Overview tab and you’ll see the Container running - denoted by the green cube under Status.

Step 2: Enable Automatic Restart of the Container.

This step requires one to update the container from outside the container, so don’t use the “console” button in the QNAP ContainerStation Overview tab.

  1. If you’re not sure how to access the QNAP directly from a Mac or PC, follow these instructions:

  1. Once you’re at the NAS command prompt, type this command: “docker update --restart unless-stopped ” without the quotes.

    Where it says put in the actual name of the container created under step 1 above. For me that was: “roon-extension-manager-1”. If you’re not sure, go to the Overview tab in the ContainerStation and note the name. Don’t use the “<” and “>” characters when entering the command.

  2. Press Enter.

  3. You’ll get a response back. For me it was the name of my container.

  4. Exit Terminal or PuTTY if using Windows.

Step 3: Installing Extension Manager in Roon and Random Radio

  1. In Roon, go to Settings and then Extensions.

  2. Click on Settings for Roon Extension Manager.

  3. Under Category, select Playback

  4. Under Playback Extension, select Random Radio

  5. Under Action, select Install.

  6. Press Save

    Once installed, you can configure the settings for Random Radio. See below for specific instructions, etc.:

Step 4: Enjoy random albums!


Hello, waiting for beta testing of version 2.0 Web Controller I installed on my Qnap Serwer Roon Extension manager. Unfortunately, the Qnap NAS uses the “: 8080” port for configuration, which is the same one that the | Web Controller uses. How can this be changed so that the Web controller uses e.g. port: 8088?
As previously mentioned, Roon Web Controller is installed on my Qnap server.
Regards Robert Tota

This can be done via port mapping as confirmed in this post.

If you created the REM container via the command line you, additionally, have to supply the -p option in the docker run command:

-p 8088:8080

This setting might also be available in the QNAP web interface, maybe another QNAP user can comment on that (not a user myself).

The above method is documented as working as well as the use of a configuration file (the method I use) for the current stable release of the extension (see here). Not sure about the alpha release though.

Path to config file on QNAP: /Container/container-station-data/lib/docker/volumes/[Optional App Name]_roon-extensions/_data/node_modules/roon-web-controller/config

Shouldn’t the question better be posted in the respective Roon Web Controller thread (stable|alpha)?

I see it’s already there:

Thank you for the hint. I will install WinSCP and find the right folder thanks to your hint to change the port on which the Web Controller is listening. For now I’m using the stable version of Web Controller 1.2.13. I look forward to the release of a more stable version than alpha because I’m worried about stability.
Thanks again Robert Tota


It seems I’m not able to download to my QNAP. What am I missing ?


I changed the search.

In addition this one was also possible to choose. I suppose it’s not the one.

Just showing the process. I left everything as default except Container Hostname. And changed network to host.

1 Like