SSH_QUICKSTART en

🇩🇪 Deutsche Version

SSH Quickstart – Bose SoundTouch

Preparation

1. Prepare USB Stick

# Run PowerShell as Admin

# Determine USB stick drive letter (e.g. E:)
Get-Volume

# Format as FAT32 (WARNING: Deletes all data!)
# Replace E: with your drive letter
Format-Volume -DriveLetter E -FileSystem FAT32 -NewFileSystemLabel "BOSE"

# Create empty remote_services file (WITHOUT extension!)
New-Item -Path "E:\remote_services" -ItemType File

IMPORTANT: The file is called remote_services – NOT remote_services.txt!

2. Verify the file was created correctly

# Must show "remote_services" (without .txt)
Get-ChildItem E:\ -Force

---

Procedure

Step 1: Connect USB Stick

1. Turn OFF SoundTouch (long press power button, orange flashing)
2. Plug USB-C adapter into USB stick
3. Insert Micro-USB end into SoundTouch "Setup-B" port (rear)
4. Turn ON SoundTouch
5. Wait 60 seconds

Step 2: Connect via SSH

# Determine SoundTouch IP (from your router or SoundTouch app)
# Your SoundTouch IP: 192.168.178.79

ssh root@192.168.178.79
# When prompted "Are you sure you want to continue connecting?" -> yes
# NO password - just press Enter

Step 3: Make SSH persistent

# On the SoundTouch (after SSH login):

# Enable SSH permanently (even without USB stick)
touch /mnt/nv/remote_services

# Verify success
ls -la /mnt/nv/remote_services

Step 4: Explore the system

# Firmware version
cat /opt/Bose/etc/version.txt

# Show current BMX config
cat /opt/Bose/etc/SoundTouchSdkPrivateCfg.xml | grep -i bmx

# Network info
ifconfig

# Hostname
hostname

Step 5: Create config backup

# Backup the original config
cp /opt/Bose/etc/SoundTouchSdkPrivateCfg.xml /mnt/nv/SoundTouchSdkPrivateCfg.xml.backup

# Verify
ls -la /mnt/nv/*.backup

Step 6: Change BMX Registry URL

# Check if override directory exists
ls -la /mnt/nv/

# Copy config to writable directory
# (Details follow after system exploration)

---

Troubleshooting

SSH: "Connection refused"

• Is the USB stick still plugged in?
• Did you restart SoundTouch after inserting the USB stick?
• Correct IP address?

SSH: "Permission denied"

• User must be root, not pi or any other name
• Do not enter a password, just press Enter

USB stick not recognized

• Formatted as FAT32?
• File is named remote_services (not .txt)?
• Used Setup-B port (not USB-A)?

---

After Successful SSH Access

Once SSH is working, we can:

1. Analyze filesystem – Where exactly is the BMX config located?
2. Test override – Is there a /mnt/nv override mechanism?
3. Change BMX URL – Point to our server
4. Test stream proxy – Preset with redirected stream