Roon server installation on Zimaos

Operating System ZimaOS
1

Hello,

I am very much a newbie using a DIY home server with ZimasOS. I would like to know if somebody could help me with the following task:

I would like to install roon server and i would like to know if it is possible via the app store.

If yes : how to do with some documentation

If not is there an other way

Thanks a lots for your answers

regards

michel

HQPLAYER to ZimaOS
2

Yes, you can definitely run Roon Server on ZimaOS, however it’s not normally available as a one-click App Store install.

The most reliable method is to run it using Docker Compose, and there is a very good community project for this on GitHub called:

elgeeko1/roon-server-docker

This project is widely used and has a clean setup for Docker-based systems like ZimaOS.

Step 1: Create the Roon data folder (important)

Open the ZimaOS terminal and run:

mkdir -p /DATA/AppData/roon-server/config

This stores your Roon database/config safely so it survives reboots and updates.

Step 2: Deploy Roon Server using Docker Compose

Create a custom compose app in ZimaOS and paste:

services:
  roon-server:
    image: elgeeko/roon-server:v1.1.0
    container_name: roon-server
    network_mode: host
    restart: unless-stopped
    volumes:
      - /DATA/AppData/roon-server/config:/opt/RoonServer
      - /DATA/Media/Music:/music:ro

Notes

  • network_mode: host is recommended because it makes Roon discovery work properly (Roon Remote can find the server easily).
  • Change /DATA/Media/Music if your music is stored somewhere else.
  • :ro means read-only (safer)

The Docker image is published under elgeeko/roon-server and version tags are available.

Step 3: Confirm it is running

Run:

docker ps

You should see roon-server running.

Step 4: Connect from your phone / PC

Install Roon Remote on your phone/computer (same network) and it should detect the server automatically.

If you are unsure of your music folder path, run:

ls -lah /DATA
ls -lah /DATA/Media

Small tip: I personally use the ZimaOS Compose Toolbox app and it’s excellent — it validates your Compose YAML and confirms the script is correct before you deploy, which avoids most beginner mistakes.

1 Like
3

Hello,

Sorry for a late answer !

I did as you explain to install Roon and it is unctionning So it is nearly perfect ( because perfect does not exist).

Thanks a lot

Regards

Miche l

4

Legend :smiley: love hearing that Michel!

Really glad you got it working and the install went smooth — and you’re 100% right… perfect doesn’t exist :joy:

If you want to take it one step further (optional), you can also:

  • pin the container image to a specific version (more stable)
  • make sure your music folder is mapped exactly how you like
  • add a dedicated SSD/NVMe location for the Roon database for best performance

But honestly if it’s running well now… leave it alone and enjoy the music

Any issues later, just post back here and we’ll help you out.

1 Like
5

I’m very happy to meet friends who also love using roon.

6

If you want the roon server to run directly on ZimaOS, you can install it using the following script:

curl -fsSL https://raw.githubusercontent.com/jerrykuku/staff/refs/heads/master/roonserver-installer-zimaos.sh | sudo bash

I just modified the installation location of the official Roon script, and the user’s application data will be installed in ZimaOS-HD/AppData/roon by default, and the main application will be installed in /opt/roon by default. Everything else remains original.

1 Like
7

You can also run Roon Rock in a VM but it is “messy” to setup as you have to add passthrough for a keyboard to the vm.

1 Like