Die Roon Server Software direkt auf der NAS laufen zu lassen, war für Besitzer eines QNAP Modells bisher besonders einfach. Seit dem 27. April 2026 funktioniert die klassische Installation über das App Center allerdings nicht mehr. Grund sind neue Mindestanforderungen an das Server-Betriebssystem ab der Software-Version Roon 2.65 bzw. 2.66 oder höher. Für viele frustrierend: nach erfolgtem Update startet der Roon Server auf dem Betriebssystem QTS dann einfach nicht mehr, ganz ohne Vorwarnung.
Die von Roonlabs angebotene Lösung ist ein sogenannter Container. Das bedeutet, der Roon Server läuft nicht mehr direkt auf dem Betriebssystem QTS, sondern bekommt einen eigenen Ordner mit den notwendigen Systemdateien, und wird fortan von einer App gestartet, die solche Container-Anwendungen verwaltet. Die eingebaute Lösung auf QNAP-NAS heißt Container Station.
Der folgende Ratgeber zeigt Schritt für Schritt, wie man Roon 2.65 und 2.66 auf QNAP-NAS konfiguriert, und unter der Container Station zum Laufen bringt. Für Nutzer anderer Systeme gilt das nicht, insbesondere für Nutzer von MacOS 10/11 und Synology DSM7.1 oder früher, bieten sich andere Alternativen an, die wir in getrennten Ratgebern behandeln werden.
Was ist ein Docker Container?
Ein Docker-Container ist ein Ordner auf einem Computer, in dem Anwendungen beziehungsweise Apps eigenständig laufen und nicht auf dem Betriebssystem installiert sind.
Einige Begriffe aus der Docker-Welt sollte man kennen:
- Docker Image – die Bauanleitung, die das Zusammensetzen des Containers beim Installieren steuert. Sie enthält Einstellungen des Nutzers wie Dateipfade, Zeitzone und Einstellungen zur Nutzung der Hardware, muss also individualisiert werden.
- Docker Container – der Ordner, der auf dem Computer installiert wird, und in dem die eigentliche Anwendung läuft. Er enthält auch die Systemanforderungen, die für die Kommunikation zwischen Anwendung und Betriebssystem notwendig sind.
- Docker Host – die Anwendung, die auf dem Rechner installiert ist und die Einrichtung/Ausführung/Starten/Stoppen der Container steuert. Eine beliebte Anwendung für viele Plattformen ist etwa Portainer oder Docker Engine, QNAP-User kennen eher die Container Station, Synology-Besitzer den Container Manager, aus früheren DSM-Versionen auch Docker-App genannt.
- Docker Hub – eine zentrale Bibliothek, um vorgefertigte Container-Images zu finden, und nach einer Bauanleitung herunterzuladen. Der Roon Container ist auf GitHub, einer sehr großen Bibliothek, veröffentlicht.
Container können auf dem Computer, auf dem sie laufen, ihre eigenen Umgebungen wie Netzwerk, Ordner, Speicherverwaltung haben. Bei der Konfiguration und Installation einer Anwendung im Container ist es deshalb wichtig, die Schnittstellen für die individuelle Kombination zu definieren. Sonst besteht die Gefahr, dass die Remote-Geräte nicht mehr mit der Server App kommunizieren können, oder letztere nicht auf Order mit Musikdateien zugreifen kann.
Warum läuft Roon Server im Docker Container auf älteren Systemen?
Die Software setzt zwar auf das vorhandene Betriebssystem auf und bringt kein eigenes mit (wie bei einer vollständigen virtuellen Maschine, die ein ganzes Betriebssystem emuliert), aber der Container kann eigenen Code, Laufzeitumgebung, Systemwerkzeuge und Bibliotheken enthalten, die dringend benötigt werden. Damit ist sichergestellt, dass die Software auch auf Betriebssystemen funktioniert, auf denen sie nicht programmiert wurde. Für Software-Entwickler ist das praktisch, weil die Anwendung sich dann auf jedem Betriebssystem ähnlich verhält, und nicht zigfach angepasst und getestet werden muss.
Diesen Trick macht sich der Roon Docker Container zunutze, der den Betrieb von Roon 2.65 und 2.66 so auch auf veralteten, inkompatiblen Betriebssystemen, wie QTS 5.x, ermöglicht.
Schritt für Schritt Anleitung zur Docker Container Installation auf QNAP Servern
Schritt 1: Backup machen im alten Roon 2.64 und Deinstallation
Ein manuelles Backup in Roon auf einen eigenen Ordner irgendwo auf der NAS, ist stark empfohlen, um die Datenbank, Playlists, Änderungen an den Alben etc., nach erfolgtem Umzug wiederherzustellen. Idealerweise sollten alle lokalen Storage-Ordner deaktiviert/disabled sein. Das geht natürlich nur, wenn man noch die alte Version nutzt, und nicht aus Versehen auf „Update akzeptieren“ geklickt hat.
Anschließend sollte man die bisherige Roon-App in App Center vollständig deinstallieren, und alle Komponenten auf dem NAS entfernen.
Schritt 2: Container Station aus dem App Center installieren
Die Verwaltungssoftware für Anwendung in Containern, muss zunächst installiert sein und laufen. Man findet sie im App Center unter Dienstprogramme:
Schritt 3: Individuellen Roon Docker konfigurieren
Es gilt nun, eine Version des Roon Servers zu generieren, die auf dem eigenen NAS läuft. Den dazugehörigen Docker Konfigurator gibt es bei GitHub. Er setzt Grundkenntnisse in der Einrichtung von Freigabepfaden auf dem jeweiligen System voraus:
Roon Server Docker Configurator bei GitHub
So sieht die Oberfläche des Docker Configurator aus, mit wichtigen Stellen, die man anpassen sollte, markiert:
Folgende Einstellungen müssen für den Betrieb auf QNAP vorgenommen, bzw. die Pfade händisch angepasst werden:
Platform > QNAP (orange markiert)
Roon Server Release Branch > Production
„VOLUMES„
Hier wird jeweils eine Umleitung für den Zugriff auf bestimmte Datenorder definiert, so dass die Roon Anwendung im Container diese sieht, und darauf arbeiten kann. Wichtig ist, dass jedem Pfad das „/share“ vorangestellt ist, und logische Volumennamen (wie „DataVol1“) nichts im Pfad zu suchen haben, sondern danach die oberste geteilte Ordnerebene benannt wird, in diesem Fall „Container“:
/share/Container/roon
Diese Pfadangabe sagt der Container Station, dass sie die Anwendung im Container in ihren eigenen Pfad namens „Container“ im Unterordner „roon“ entpacken und zum Laufen bringen soll. ACHTUNG: In diesem Ordner legt Roon auch die eigene Datenbank ab, auf die es sehr oft und sehr schnell zugreifen muss. Es empfiehlt sich daher dringend, diesen Systempfad auf einen SSD-Speicher zu leiten, nicht auf eine magnetische Festplatte/HDD. Wenn der Ordner „Container“ bereits auf einer magnetischen Platte liegt, kann man nach Belieben einen neuen Ordner auf einem SSD-Volume anlegen und hier eintragen, idealerweise mit einem Unterordner „roon“. Ist gar kein elektronischer Speicher installiert, empfiehlt sich die Umleitung auf eine externe USB-Flashdrive, die aber unbedingt schnell sein muss. Dann lautet der Pfad etwa, wenn die externe Platte „MySSD“ heißt und zwingend im EXT4-Format formattiert werden muss:
/share/MySSD/roon
Weiter geht es mit dem Verweis zur lokalen Musiksammlung unter „/Music“. Beispiel, wenn die Musik im bei QNAP-Systemen typischen Hauptorder „Multimedia“ liegt und dem Unterordner „Music“ (rot markiert im Screenshot):
/share/Multimedia/Music
Anschließend benötigt es noch den Pfad zum in Schritt 1 gemachten Datenbank-Update, zum Beispiel:
/share/Container/roon-backups
In diesen Ordner wird Roon auch zukünftig Backups speichern, deshalb ist ein lokaler Ordner besser. Hat man bereits ein Backup auf einem externen USB-Stick, kann man es über die File Station in den Backup-Ordner kopieren, den Roon zukünftig sieht.
Die weiteren Optionen sollten überprüft werden, wie die Zeitzone, und die Aktivierung/Deaktivierung von lokalen Audio-Ausgängen wie USB-Audio und HDMI.
Schritt 4 Docker Compose als .YML herunterladen
Stimmen alle Einstellung, kann man mit dem kleinen Download-Button im GitHub Konfigurator eine .YML-Datei herunterladen. Sie enthält die komplette Anleitung zum Installieren von Container und Anwendung auf dem NAS.
Schritt 5: Container pullen und Anwendung generieren in Container Station
In der App Container Station auf dem QNAP NAS wählt man die Rubrik „Anwendung“/“Application“ (Orange) und dann die Funktion „Erzeugen“/“Create“ (rot markiert):
Es öffnet sich ein Fenster zum Erzeugen einer Anwendung. Übr die Funktion „Upload“ kann man vom lokalen Computer, oder einem Ordner auf dem NAS, die .YML Datei hochladen. Alternativ kann der YAML-Code, der im letzten Schritt generiert wurde, auch einfach in das Textfeld kopiert werden. Dann anschließend mit „Create“ bestätigen. Die Container Station sollte jetzt die Einrichtung vornehmen, die Anwendungsdaten herunterladen, und Roon direkt im Container starten. Das kann man überprüfen mit der Ansicht „Container“:
Im schwarzen Textfeld tauchen evtl. Fehlermeldungen auf, etwas wenn nicht auf die verwendeten Ordner zugegriffen werden kann, oder etwas bei der Installation schiefgegangen ist. Dass der Container selbst mit grünem Licht den Betrieb anzeigt, heißt noch nicht, dass die Anwendung Roon Server auch wirklich läuft. Zum Überprüfen empfiehlt sich ein Blick auf die Übersichtsseite der Container Station. Der Bedarf an Arbeitsspeicher/RAM sollte sich signifikant erhöht haben.
Schritt 6 Roon Remote verbinden und Backup wiederherstellen
Tablet, Computer oder Smartphone mit der Roon Remote App starten. Die Remote App wird den neuen Roon Server nicht automatisch finden, wozu die „Mit einem anderen Roon Server verbinden“ Funktion dient. Meist fragt der neue Roon Server dann auch nach einem erneuten Login mit Nutzername und Passwort.
Anschließend sollte man das letzte Backup der internen Roon-Datenbank wiederherstellen. Dazu gibt es eine eigene Funktion unter „Einstellungen > Backups“. Wichtig ist dabei, dass sich die Backup-Daten wirklich in dem Ordner befinden, den wir in Schritt 3 unter „Backups“ mit dem Container geteilt haben.
Ist das Backup wiederhergestellt, einen kurzen Blick in die Einstellungen „Storages“ in Roon werfen. Der neue, mit dem Container geteilte Musikpfad sollte jetzt zu sehen sein, meist noch nicht aktiviert. Es empfiehlt sich, vor dem aktivieren dieses Ordners die älteren Ordner, die Roon Server jetzt nicht mehr findet, zu löschen. Damit macht man es dem Roon Server einfacher, Alben wiederzuerkennen. In einigen Ausnahmefällen kann es aber passieren, dass Alben nicht erkannt werden.
Viel Erfolg!
Detailliertere Anleitungen zum Installieren von Roon Server im Docker Container von Roonlabs (Englich)
Roonlabs hat unter dem folgenden Link eine etwas abweichende Anleitung zur Einrichtung von Roon Server in einem Docker Container auf QNAP veröffentlicht:
Roonlabs Anleitung für Roon Docker Container unter QNAP QTS
Sie enthält weitere Details. Wenn die Einrichtung nicht funktioniert, empfehlen wir einen Besuch des Roon Community Forums unter Angabe der individuellen Fehlermeldungen, die die Container Station produziert. Mit inkorrekten Namen innerhalb der Pfade, Benennung der Volumes und Zugangsberechtigungen zu einzelnen Ordnern, gibt es immer wieder individuelle Probleme bei der Docker Installation.
