You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
During the setup wizard, OCT creates full partition-level backups on the USB stick plugged into your SoundTouch device. You'll find them in /media/sda1/oct-backup/:
File
Contents
Typical Size
soundtouch-rootfs.tgz
Complete root filesystem (/) β system binaries, Bose app, config
Firmware update cache (/mnt/update) β installer staging area
~0.9 MB
The wizard also saves individual config files as .bak:
SoundTouchSdkPrivateCfg.xml.bak β the cloud URL config
hosts.bak β the DNS override file
Partition Layout (ST10, Firmware 27.x)
Partition
Mount Point
Size
Access
ubi0:rootfs
/
~81.4 MB
Read-only (default)
ubi1:persistent
/mnt/nv
~31.5 MB
Read-write
ubi2:update
/mnt/update
~7.9 MB
Read-write
The root filesystem is mounted read-only during normal operation. You must remount it before writing.
Full Restore (all partitions)
Prerequisites
USB stick with oct-backup/ folder plugged into the speaker
SSH access enabled (same remote_services USB trick used during setup)
Steps
1. SSH into the device:
ssh -oHostKeyAlgorithms=ssh-rsa root@<SPEAKER-IP>
2. Verify USB is mounted:
grep '/media/' /proc/mounts
ls -la /media/sda1/oct-backup/
3. Restore /mnt/nv (persistent data β presets, WiFi, tokens):
Already writable, no remount needed:
cd / && tar xzf /media/sda1/oct-backup/soundtouch-nv.tgz
4. Restore /mnt/update (firmware cache):
Also writable by default:
tar xzf /media/sda1/oct-backup/soundtouch-update.tgz
5. Restore rootfs (system partition):
Root is read-only β remount first:
rw || mount -o remount,rw /
cd / && tar xzf /media/sda1/oct-backup/soundtouch-rootfs.tgz
mount -o remount,ro /
The rw shortcut exists on some firmware versions. mount -o remount,rw / is the universal fallback.
6. Reboot:
reboot
Device restarts with original factory config. Give it ~60 seconds to fully boot.
Quick Restore (config only β undo OCT setup)
If you only want to revert OCT's config changes (cloud URLs + DNS overrides), you don't need a full restore:
rw || mount -o remount,rw /
cp /media/sda1/oct-backup/SoundTouchSdkPrivateCfg.xml.bak /opt/Bose/etc/SoundTouchSdkPrivateCfg.xml
cp /media/sda1/oct-backup/hosts.bak /etc/hosts
mount -o remount,ro /
reboot
After reboot, the device points back to the original Bose cloud servers.
Can I restore from the OCT web UI?
Partially. The Setup Wizard (Step 8) has config and hosts restore buttons for the quick restore. But full partition-level restore is SSH-only β the web UI doesn't support extracting tar archives onto the device.
What if I lost my USB stick / backups?
Factory reset via the device's physical buttons (refer to Bose support docs for your model)
Manual config editing β if you know what OCT changed, you can manually revert the XML config and /etc/hosts
reacted with thumbs up emoji reacted with thumbs down emoji reacted with laugh emoji reacted with hooray emoji reacted with confused emoji reacted with heart emoji reacted with rocket emoji reacted with eyes emoji
Uh oh!
There was an error while loading. Please reload this page.
-
What does the OCT setup wizard back up?
During the setup wizard, OCT creates full partition-level backups on the USB stick plugged into your SoundTouch device. You'll find them in
/media/sda1/oct-backup/:soundtouch-rootfs.tgz/) β system binaries, Bose app, configsoundtouch-nv.tgz/mnt/nv) β presets, tokens, WiFi configsoundtouch-update.tgz/mnt/update) β installer staging areaThe wizard also saves individual config files as
.bak:SoundTouchSdkPrivateCfg.xml.bakβ the cloud URL confighosts.bakβ the DNS override filePartition Layout (ST10, Firmware 27.x)
ubi0:rootfs/ubi1:persistent/mnt/nvubi2:update/mnt/updateThe root filesystem is mounted read-only during normal operation. You must remount it before writing.
Full Restore (all partitions)
Prerequisites
oct-backup/folder plugged into the speakerremote_servicesUSB trick used during setup)Steps
1. SSH into the device:
2. Verify USB is mounted:
grep '/media/' /proc/mounts ls -la /media/sda1/oct-backup/3. Restore
/mnt/nv(persistent data β presets, WiFi, tokens):Already writable, no remount needed:
4. Restore
/mnt/update(firmware cache):Also writable by default:
5. Restore rootfs (system partition):
Root is read-only β remount first:
6. Reboot:
Device restarts with original factory config. Give it ~60 seconds to fully boot.
Quick Restore (config only β undo OCT setup)
If you only want to revert OCT's config changes (cloud URLs + DNS overrides), you don't need a full restore:
rw || mount -o remount,rw / cp /media/sda1/oct-backup/SoundTouchSdkPrivateCfg.xml.bak /opt/Bose/etc/SoundTouchSdkPrivateCfg.xml cp /media/sda1/oct-backup/hosts.bak /etc/hosts mount -o remount,ro / rebootAfter reboot, the device points back to the original Bose cloud servers.
Can I restore from the OCT web UI?
Partially. The Setup Wizard (Step 8) has config and hosts restore buttons for the quick restore. But full partition-level restore is SSH-only β the web UI doesn't support extracting tar archives onto the device.
What if I lost my USB stick / backups?
/etc/hostsBeta Was this translation helpful? Give feedback.
All reactions