Bose wollte im Februar 2026 die Cloud-Dienste für diverse SoundTouch-Modelle abschalten.
Nach Rückmeldung von der Nutzerschaft, dass das eine dumme Idee ist, wurde die Frist auf ende Mai 2026 verlegt.
Zusätzlich wurden diverse Dokumente veröffentlicht, wie man das Gerät per API vollständig bedienen und übernehmen kann.
In dieser Anleitung setzen wir ein lokalen Server auf, damit wir alle Bose SoundTouch-Geräte damit verbinden können.
Somit funktionieren sie auch nach dem Abschaltdatum der Cloud mit so gut wie allen Funktionen weiterhin.
Wir installieren uns OpenCloudTouch (OCT) als Docker Container, um damit den SoundTouch wieder vollständig bedienen zu können.
Was brauchen wir alles?
– Einen Linux-Server (Raspberry Pi / x86/x64 Server, …)
– Docker
– Vollen Root-Zugriff auf das System
– Ein USB-Stick mit min. 512MB Speicherplatz
– Je nach Gerät ein USB-Adapter (USB A auf Micro-USB)
1. Server aufsetzen
Richte dir einen Server ein, auf dem Docker installiert werden kann.
Der Server muss dauerhaft laufen, denn der SoundTouch benötigt ihn als Vermittlungsstelle.
Er ist quasi deine private Cloud zuhause.
Der Server an sich braucht keine Leistung.
Deshalb eignet sich auch ein Raspberry Pi oder schwacher Mini-PC.
Auch dein NAS wäre ausreichend, sofern das Teil Docker unterstützt.
Wer möchte und passende Hardware hat, kann das Ding auch auf seinem Router installieren (lol).
Der Server braucht nur 500MB freien RAM und 1GB Speicherplatz.
Diese Anleitung beschreibt NICHT, wie man den Server einrichtet!
2. Docker installieren
Installiere Docker auf deinem System.
Diese Anleitung beschreibt NICHT wie das geht, da je nach eingesetztem Betriebssystem die Installation von Docker unter Umständen etwas spezieller ausfallen kann.
Wie man z.B. Docker in einem LXC bei Proxmox installieren kann, kannst du HIER lernen.
3. Container ausrollen
Hier findest du erst einmal alle wichtigen Dokumente, Links und Befehle:
>> GitHub Projekt
>> Das Wiki (auch in deutsch)
Erstelle einen Ordner, worin alles gespeichert werden kann und geh in diesen.
mkdir -p /opt/OpenCloudTouch cd /opt/OpenCloudTouch
Lege darin die Docker-Compose.YML an und befülle sie mit Inhalt.
nano docker-compose.yml
INHALT:
services:
opencloudtouch:
image: ghcr.io/scheilch/opencloudtouch:latest
container_name: opencloudtouch
network_mode: host
volumes:
- oct-data:/data
environment:
- OCT_HOST=0.0.0.0
- OCT_PORT=7777
- OCT_LOG_LEVEL=INFO
- OCT_DISCOVERY_ENABLED=true
restart: unless-stopped
volumes:
oct-data:
driver: local
Hinweis: Wenn der Port 7777 auf deinem System bereits belegt ist, ändere einfach den Port bei OCT_PORT ab.
(Aktuell ist das Port ändern NICHT möglich. >> Hinweis bei Github!)
Starte nun den Container.
docker compose up -d
4. OpenCloudTouch aufrufen
Öffne einen Webbrowser und rufe nun OpenCloudTouch auf.
Die Anwendung ist über die IP-Adresse mit dem OCT_PORT nun erreichbar.
http://192.168.XXX.XXX:7777
HTTPS ist nicht aktiv.
5. Bose SoundTouch einschalten
Schalte nun dein SondTouch ein und lass mal was abspielen.
Hauptsache das Ding ist aktiv im Netzwerk und kann gleich gefunden werden.
6. Das Gerät übernehmen
Lass nun das Gerät nun von OCT finden und klicke dann auf das Zahnrad beim Gerät selbst, um es sauber konfigurieren zu können.
Folge nun den Anweisungen, die das Setup nun Schritt für Schritt dir anzeigt.
So sieht der Inhalt des Backups auf dem USB-Stick aus.
Wie kann ich die Modifikation rückgängig machen?
Setz einfach den Lautsprecher auf Werkseinstellungen zurück.
Wenn du lieber das Backup einspielen möchtest, findest du die passende Hilfe über das Zahnrad zum Einrichten des Lautsprechers.
Sind die Modifikationen permanennt?
Ein Neustart überleben sie. Wenn du das Gerät zurücksetzt, sind sie weg.
Funktioniert die Webseite zum Verbinden mit einem anderen WLAN noch (SoundTouch Access Point Setup)?
Ja die ist weiterhin da. Wir haben die Firmware ja nicht modifiziert.
Bei mir leuchtet nur die gelbe LED! Was tun?
Dieses Problem ist mit OpenCloudTouch v1.4.1 behoben.
Solltest du deinen Lautsprecher mit einer früheren Version umgestellt haben, führe die Einrichtung noch einmal aus.
Also Stick dran, Lautsprecher umstellen lassen, neu starten.
Danach sollte alles wieder wie gewohnt funktionieren.
Ich kann SSH nicht aktivieren! Was tun?
Der SoundTouch 20 hat scheinbar 2 USB-Ports. Einen Micro-USB und einen Typ-A.
Versuch den USB-Stick an beiden Ports.
Es gab auch schon den Fall, dass das Adapterkabel von Micro-USB auf Typ-A nur ein Strom-Kabel war und kein Datenkabel.
Achte darauf, dass dein Adapterkabel ein Datenkabel ist!
Bei manchen hat es geholfen, beim Starten die Taste 1 (Preset 1) gedrückt zu halten.
Ich habe Problem XYZ! Was tun?
Schau in die Kommentare unter diesem Breitrag, unter dem YouTube-Video oder bei Github (Issues) vorbei.
Die meisten Probleme sind dort mittlerweile aufgeführt und in der Regel sogar gelöst.
Befolge die Anleitung, dann funktionierts auch 🙂
Diese Anleitung wurde mit einem Bose SoundTouch 10 und Debian 13 getestet. Andere Geräte und Systeme wurden nicht getestet!
Hallo,
ich versuche die Server-Applikation unter Unraid als Docker zu installieren. Dazu würde mir noch ein Icon fehlen.
Gerne würde ich auch das Loglevel ändern – leider führt der Link für die Parameterliste auf einen Fehler.
Unabhängig davon – eine tolle Arbeit, Respekt !
Gerne die Wünsche über Github an den Entwickler stellen.
Ich kann hier nicht viel tun 🙂
Hallo, vielen Dank für das super Video und die Erklärung. Ich habe den DockerContainer auf meiner Synology laufen. Die Einrichtung meines Soundtouch 20 hat wie im Video gut geklappt. Ich bin auch mit dem Gerät verbunden. Jetzt habe ich die Presets geändert. Klicke ich auf Play bzw auf eine Taste, dann erscheint kurz der Sendername und dann „Wählen Sie ein Preset oder Erkunden sie Musik in der SoundTouch App“. Dabei wird nichts abgespielt. Auf dem Gerät befindet sich die letzte Firmware 27.x.
Hast du ggf eine Idee wo das Problem liegen könnte?
Viele Grüße
Daniel
Hallo, auch von meiner Seite super vielen Dank für das super Video und die detaillierte Erklärung.
Ich habe den DockerContainer auf meiner Qnap laufen. Die Einrichtung meines Soundtouch 10 hat gut geklappt. Ich bin auch mit dem Gerät verbunden. Auch ich habe die Presets wie in Ihrem Video in Opencloudtouch geändert. Wenn ich dort auf „play“ drucke schaltet den Soundtouch 10 ein (also Opencloudtouch macht Verbindung mit mein Soundtouch 10) und auf den Soundtouch 10 wird den rechter LED ganz kurz weiß und danach gleich gelb…
Im Internet habe ich Vtuner.com aufgerufen und den gleichen Sender eingegeben. Auf meinen Rechner funktioniert Vtuner.com einfach und spielt die Musik. Anscheinend macht den Soundtouch 10 keine Verbindung mit Vtuner.com…
Die Domains zu vtuner.com sind in der Hosts-Datei umgebogen.
Nutze am besten den direkten Stream des jeweiligen Radio-Senders.
Ein Neustart und 5min. warten hilft hier auch eventuell.
Musste den ST10 im Video mal 3-4 Minuten Zeit geben, bis er die gewünschten Streams wieder abgespielt hat.
Ist halt nicht das schnellste Teil 🙂
Ergänzung: das Programm Opencloudtouch zeigt rechts oben ein grüne „V“ (wo vorher „Gerät einrichten“ stand), aber gibt weiter nach unten (oberhalb den Lautsträke Schieber) „Kein Sender“ an (wo in Ihre Beitrag SWR3 stand)…
Hallo,
ein großes DANKESCHÖN. Ich habe es geschafft 4 Soundtouch 10 und einen Soundtouch 20 wieder nutzbar mit den Presets zu machen. Danke. Da ist die Freude groß.
Ich schaffe es aber leider nicht, das Wave Soundtouch Modul über ssh zu erreichen. Ich vermute, dass es nicht einfach über den Stick startet. Das ist verrückt. Eine Idee, wie man das Soundtouch Modul dazu bekommt in den Wartungsmodus zu gehen und um somit mit ssh über ein Terminal ansprechbar zu sein?
Jetzt schon vielen lieben Dank.
Viele Grüße
Martin
Hey!
Das Wave Gerät wird nicht unterstützt.
Aktuell funktioniert die Anleitung nur mit SoundTouch 10/30/300.
Ich selbst hab keine weiteren Bose-Geräte, daher kann ich auch nichts testen.
Vielen Dank.
Hallo,
ich bin noch nicht am End, da mir der (Micro) USB Stick für den ST10 fehlt.
Was ich aber schon gemerkt habe, dass beim Formatieren mit anderen USB Sticks der Name gekürzt wird. Ich bekomme das auf keinem den beiden Weg in Win11 hin, dass der analog der Anleitung voll ausgeschrieben wird.
Wir mich als DAU auch noch zur Sicherheit, wenn da steht, dass der USB Stick reingesteckt werden soll, ist der Soundtouch gemeint.
Welchen Namen der USB-Stick bekommt, ist vollkommen egal. Der kann auch einfach wegfallen.
Wichtig ist nur, dass er im FAT32-Format ist.
Ich bin die Anleitung jetzt auch zweimal durchgegangen.
Die Tests am Ende werden als erfolgreich gemeldet.
Danach ändere ich die Presets.
Beim Anwählen, auch nach langer Wartezeit, spielt der ST10 nichts ab und die rechte LED leuchtet nur gelb.
Das Problem habe ich auch. Eine ST10 geht, die andere nicht. Die nicht geht wurde zurückgesetzt und hat nun einen anderen Devicenamen, weil die SoundTouch-App mich nur das WLAN setzen lässt. Ansonsten laufen bei beiden die Tests erfolgreich durch
Ich konnte beim ST20 und beim Wave ST über das Webif vom opencloudtoch bei beiden Geräten die Presets Bose serverunabhängig neu belegen. Den ST20 konnte ich per ssh „übernehmen“, den Wave ST nicht. Für den Wave ST habe ich die Anfragen per Pihole umgeleitet. Seit dem 7.Mai funktionieren die Presets bei beiden Geräten nicht mehr. Mit dem Umgang der geupdateten Bose SoundTouch App hab ich mich bisher zurückgehalten, ich weis nicht was passiert.
Ich habe exact das gleiche problem,…
Seid Version 1.2.5 habe ich den Dockercontainer gelöscht und beide ST10 Factory resettet. Jetzt gehen bei beiden keine Presets mehr, also nur kurz die Anzeige lägt, LED blinkt und nichts mehr….
Installation hat wunderbar geklappt. Danke für die Mühe!. Leider kann auch ich keine Sender abspielen (ST30). Die Preset kann ich setzten, Sender werden gefunden und angeboten, aber nicht nach Auswahl abgespielt bzw. in das Abspielfenster übertragen. Für Tipps wäre ich natürlich dankbar
Hallo Michael, leide unter dem gleichen Problem, konte es aber lösen.
Wenn du den setup-assistenten komplett fertig hast, nochmal von vorne beginnen und alles überspringen was nicht für die Weiterleitung auf die nächste Seite notwendig ist. Für das SSH ist kein Geräteneustart notwendig, das Backup unbedint auslassen, sonst wird das Original überschrieben (oder vorher wegsichern, aber eine neues Backup ist nicht notwendig) auf der Seite an der die 3 URL noch anzuhaken sind, steht oben die IP für den OpenCloudTouch-Server und die muß der IP des Gerätes entsprechen, auf dem die die Software und auch Docker installiert hast. Bei mir wurde hier 127.0.0.1 angezeigt und das ist falsch!
Das wird auch in die Hosts-Datei eingetragen un daher socht der Sounttouch auf sich selber?? Also hier die IP deines Servers eintragen und die Host-Datei mit der Schaltfläche untehlab neu schreiben. Die folgende Seite mit dem Test kannst Du vergessen, die zeigt dann fehler an und du kannst nicht mehr weiter schalten auf die nächste Seite. sobal die Datei neu geschrieben ist das Gerät neue starten, die Website schließen und neu aufrufen. Sobald das Gerät wieder online ist die Presets neu vergeben und da läfut das. Bei mir zumindest 🙂
abe das gleiche Problem wie alle hier vor mir, ST10 und Docker- und Cloudinstallation hat alles wunderbar nach Anleitung geklappt. Aber egal welchen Preset ich neu anlege und nutzen möchte, es kommt nur die gelbe LED.
Auch bei mir das gleiche Problem.
Gerät lässt sich mit der Top Anleitung einwandfrei übernehmen, Sender können in die Presets belegt werden aber der Sender wird nicht gestreamt.
Hatte erst Version 1.2.2 und nun 1.2.8 in der Hoffnung das es ein Bug in der Version war aber leider geht es auch mit der Version 1.2.8 nicht.
Wenn jemand Lösungsansätze hat dann immer her damit. Das Thema Hosts Datei kann ich bei mir ausschließen. Diese wurde korrekt umgeschrieben.
Genau das selbe Problem habe ich auch. Die Installation läuft ohne Fehler durch, die Presets können gesetzt werden – alles grün. Der ST10 spielt aber nichts ab. Sender nicht gefunden.
Bei der Installation ist mir aufgefallen, dass es mittlerweile Unterschiede zwischen TUT und Webseiten während der Installation gibt. Außerdem: im TUT zieht sich die IP-Adresse durch. Bei mir wird während der Installation die lokale Adresse des Docker vorgeschlagen. Wenn ich diese ändere, kommt es zu einem Fehler. Vielleich hilft das bei der Fehlersuche.
Das Problem ist gelöst. Ich hatte den Kommentar des „andere Andreas“ vom 14.05. erst verstanden nachdem ich meinen Post abgesetzt hatte.
Letztes verbliebenes Problem bei meinen STs.
Der SSH-Zugang zum ST30 funktioniert nicht. Entweder liest er die remote_services nicht oder … ???
Gibt es Ideen?
Habe mittlerweile den Kommentar des „anderen Andreas“ nicht richtig verstanden. Genauso hat es jetzt auch bei mir funktioniert.
Einziges verbleibendes Problem bei meinen Geräten: beim ST30 lässt sich SSH nicht freischalten. Hat dazu jemand eine Idee?
Hallo,
ich hatte dasselbe Problem. Ich gehe davon aus, dass du den passten USB Stick verfügbar hast. Dann die Box mit eine Lan-Kabel anschliessen. Neu starten, Serup noch mal an starten und dann funktioniert es. Zumindestens bei mir. Das Lan-Kabel benötigst du nur einmal dafür.
Danke für den Tipp mit dem LAN-Anschluss. Ich habe es sofort probiert. Leider ohne Erfolg. Wir haben 3 x ST10 und 1 x ST30 im Einsatz. Der Stick hat bei den ST10 funktioninert. Dann sollte er auch im ST30 funktionieren, oder?
Hallo und vielen Dank für das Teilen deines Engagements!
Meine ST20 wird von OCT gefunden, die remote_services (mit touch unter Linux am Terminal erstellt) liegt auf einem 4.0 GB DOS_FAT_32 Stick und hängt an einem OTG-Adapter im Micro-USB Eingang der Box. Leider lande ich beim SSH-Befehl immer bei Connection refused.
Probier mal den USB-Stick am normalen USB Typ-A Port.
Bei manchen hat das scheinbar geholfen.
Kann es selbst nicht testen, hab kein ST20.
Ich hatte mich nicht klar ausgedrückt. Ich nutzte bei den ST10 einen USB-A-Stick mit Adapter von USB-A auf Micro-USB. Also konnte ich den selben USB-A-Stick für die ST30 verwenden.
ABER: Ich habe gerade eben weitere Sticks mit gparted auf fat32 und 1.024 MB formatiert und diese Sticks verwendet … und siehe da. Mit einem anderen Stick konnte ich SSH freischalten. Der Rest nach Plan. Auch hier musste ich die IP-Adresse des Cloudservers von Hand korrieren, so dass der abschließende Test offiziell fehlgeschlagen ist. Nach einem Neustart funktioniert die Box trotzdem.
Was wäre die Welt ohne Communities. Danke allen die an dem Projekt mitwirken!
Das hatte ich bereits alternativ getestet aber gleiches Ergebnis.
super video, anlegen des Dockers auf RASPI klappt super. Open Cloud Touch läuft super. Soundtouch 10 wird erreicht.
Aber der SSH Zugang zur Soundtouch 10 klappt nicht.
Habe schon verschiedene Sticks ausprobiert. Mal unter Windows in FAT32 formatiert und Datei „remote_services“ angelegt, das gleiche unter Linux von meinem RASPI aus.
Beim einstecken des Sticks und starten der Box ist keine SSH Verbindung möglich.
Das Kabel Micro-USB auf USB-A funktioniert korrekt. Ich kann mit der Bose Soundtouch APP die Box einrichten.
Ich habe mir jetzt noch einen anderen Adapter USB-A Kupplung auf micro USB
Stecker bestellt und hoffe, das es dann funktioniert.
Kann vielleicht einer bei dem es geklappt hat seinen Adapterstecker angeben.
Hallo, die Community ist im Gegensatz zu mir schon sehr weit fortgeschritten; ich stecke schon in den Anfänngen fest. Raspi 4 ist mit dem korrekten Image in Betrieb; die IP ist im Netz sichtbar und der Raspi via SSH ansprechbar. Ich komme allerdings nicht auf das Webinterface. IP stimmt, Port 7777 stimmt, Firewall und Proxy testweise ausgeschaltet, verschiedene Browser getestet… Ich habe keinen Plan!
Hallo, es lag wirklich am Adapterkabel, dass der USB Stick an der Soundtouch nicht richtig erkannt wurde. Hatte mir Amazon den Adapter
PremiumCord USB Adapterkabel F/M, USB Typ A Buchse auf Typ Micro Stecker, HighSpeed 480 Mbit/s, Farbe Schwarz, 20cm, OTG
bestellt . Mit dem hat es dann auch super geklappt.
Die Versorgung der Presets ist ja sehr schön gelöst, aber wenn der gewünschte Sender nicht versorgt ist oder die versorgte Adresse nur den Sender mit einer bescheidenen Samplerate wiedergibt.
Es wäre schön, wenn man die hinterlegten IP Adressen für die Presets editieren und anpassen könnte.
In der Oberfläche von Open Cloud Touch wäre das super, aber es würde auch reichen, wenn man das auf dem Docker editieren kann.
Ich kann nun auch Erfolg bei meinem ST10 vermelden. Habe mir das erwähnte Adapterkabel „PremiumCord USB Adapterkabel F/M, USB Typ A Buchse auf Typ Micro Stecker, HighSpeed 480 Mbit/s, Farbe Schwarz, 20cm, OTG“ und einen kleineren USB Stcik besorgt.
Jetzt funktioniert es nach Anleitung. Vielen Dank!
Hallo zusammen,
habe alles prima zum laufen bekommen, presets werden gespeichert, die Tests sehen OK aus, aber bei dem Lautsprecher steht immer „Kein Sender“ und es wird nichts abgespielt. Wenn ich die Lautstärke an der Box ändere wird das auch im Webinterface angezeigt. Die Kommunikation tu also im Prinzip.
Habe auch den Tipp von Andreas vom 14. Mai bzgl. 127.0.0.1 ausprobiert, aber dann kommt beim Testen die Meldung, das nicht alle adressen wie erwartet umgestellt sind.
Wenn ich mit ssh auf das Gerät gehe, sieht die /ezc/hosts eigentlich OK aus:
root@rhino:etc# cat hosts
127.0.0.1 localhost.localdomain localhost
# OCT-START
[MeineIP] bose.vtuner.com # OpenCloudTouch redirect
[MeineIP] bose2.vtuner.com # OpenCloudTouch redirect
[MeineIP] primary5.vtuner.com # OpenCloudTouch redirect
[MeineIP] primary6.vtuner.com # OpenCloudTouch redirect
[MeineIP] streaming.bose.com # OpenCloudTouch redirect
[MeineIP] bmx.bose.com # OpenCloudTouch redirect
[MeineIP] api.bosesoundtouch.com # OpenCloudTouch redirect
[MeineIP] content.api.bose.io # OpenCloudTouch redirect
[MeineIP] events.api.bosecm.com # OpenCloudTouch redirect
[MeineIP] worldwide.bose.com # OpenCloudTouch redirect
[MeineIP] update.bose.com # OpenCloudTouch redirect
[MeineIP] analytics.bose.com # OpenCloudTouch redirect
[MeineIP] telemetry.bose.com # OpenCloudTouch redirect
# OCT-END
Irgendwelche Ideen?
Versuch mal einen Sender über das Webinterface zu starten. Falls das nicht geht, führe die Einrichtung noch einmal durch, das könnte helfen.
Habe den im Video zu sehenden SoundTouch vor 3 Tagen auch noch einmal müssen frisch Umstellen, da diverse Fehler in OCT behoben wurden.
Wenn man sich strikt an die Anleitung hält, sollte alles funktionieren.
Hallo
Ich wollte mich nur kurz bedanken, deine Anleitung hat mir weitergeholfen.
Ich habe keinen PI verwendet sondern eine QNAP TS-… darauf dann Container Station installiert, darin dann Anwendung \ Erstellen > Namen vergeben > als Code den Code aus „docker-compose.yml“ eingefügt > danach auf Hochladen >>> und danach lief alles wie von selbst … keine Probleme mehr einfach Anweisungen folgen und in unter 5 Minuten fertig …
Also Danke nochmal
Habe die Box nochmal komlett resettet und neu eingerichtet.
Jetzt kommt die Meldung „Nicht alle Host-Einträge verweisen auf die erwartete IP“ obwohl alle Einträge ausser localhost auf die OpenCloudTouch IP zeigen.
Hallo,
nachdem ich OCT nochmal neu installiert habe, läuft es jetzt!
Zu erst hatte ich noch ein Problem nachdem ich den BS10 am bereits laufen hatte. Ich hatte ihn an einen anderen AP umgehängt, und dort war er nicht mehr erreichbar, obwohl die die AP’s im gleichen WLAN und in einem geswitchen Netz hängen.
Es war allerdings dann ein zusaätzlicher Switch dazwischen und nach einigem suchen habe ich festgestellt das in dem Defaultnetzwerk Multicast nicht aktiviert war. Nachdem ich das aktiviert habe läuft es.
OCP läuft unter Portainer auf eine Synology 918+ und das Netz mit Unify Switches und AP’s.
Danke nochmal für die Anleitung und Unterstützung!
das ist top….meine 2 x ST10 laufen wieder….die Soundbar war etwas tricky…läuft aber nun auch. Man muß wohl während dem restart eine Taste auf der FB gedrückt halten ( 2te Reihe , 2te Taste)
Ich hatte auch schwierigkeiten SSH zum laufen zu bekommen. Ich habe 2 Kabel, 4 USB-Sticks und Stunden mit rum probieren verbracht doch am ende habe ich eine Lösung gefunden.
Ich habe die Aktuellste Firmware auf die SP10 installiert und danach direkt den Stick angeschlossen und siehe da….SSH in da House.
Vielleicht hilft es ja dem ein oder anderen.