This toolkit helps you keep your Bose SoundTouch speakers functional even after the Bose Cloud shutdown in May 2026. It emulates the necessary cloud services locally on your network.
Create an empty file named remote_services on a USB stick.
Insert it into the speaker's SERVICE port and reboot the speaker.
Verify connection:
Use the Migration tab to select your device and verify that SSH Connection shows ✅ Success.
Or manually: ssh -oHostKeyAlgorithms=+ssh-rsa root@<SPEAKER-IP> (no password).
Settings: Review the Settings tab. Ensure the "Target Domain" and "Proxy Domain" use an IP address or domain name that is accessible from your speakers (usually the IP of this server on your local network).
Discovery: Go to the Devices tab to find your speakers on the network.
Ensure your speakers are powered on and connected to the same network.
Data Sync: In the Data Sync tab, fetch your current presets, recents, and sources.
This step is critical to ensure your local service has all your personalized data before you disconnect from the Bose cloud.
Migration: In the Migration tab, redirect your speaker to this local service.
We recommend the XML Configuration method as it is surgical and easily reversible.
Verification: After migration and reboot, your speaker will communicate with this toolkit instead of Bose servers.
⚠️ Safety First: Before starting any migration, please read our
Professional Migration & Safety Guide.
The toolkit automatically creates backups, but understanding the process is key to a smooth transition.
Note: These URLs must be accessible from your SoundTouch devices.
Use the IP address of this server on your local network (e.g., http://192.168.1.100:8000)
rather than localhost.
(Standard services URL)
(Upstream proxy URL)
Proxy Logging:
Known Devices 🔍 Scanning...
Loading devices...
Initial Data Sync
Before migrating, fetch your presets, recents, and configured sources from the device to ensure they are available locally.
Sync Results
Device Migration
Command Output
Migration Summary for
SSH Connection:
Backup: ✅ Found .original config at /opt/Bose/etc/SoundTouchSdkPrivateCfg.xml.original
Backup: ❌ Not found
Remote Services Enabled:
Local Root CA Trusted:
HTTPS Connection Test: Verify the device can reach the server over HTTPS.
URL:
Preliminary /etc/hosts Test: Verify the device's /etc/hosts mechanism before full migration.
Domain: custom-test-api.bose.fake
Original Config (Backup)
Service Implementations
Service
Original URL
Implementation
Marge (Streaming)
loading...
Stats
loading...
Software Update
loading...
BMX (Registry)
loading...
Current Config (on Speaker)
Planned Config (Soundcork)
Planned /etc/hosts Entries
Note: This method also injects the local Root CA into /etc/pki/tls/certs/ca-bundle.crt to enable secure HTTPS communication.