Skip to content
Documentation
Getting Started

Getting Started

Get OpenCloudTouch running in three steps.

Prerequisites

  • A Raspberry Pi 4/5 (or any Linux machine / Docker host on your network)
  • One or more Bose SoundTouch speakers on the same network

Option A: Raspberry Pi Image (Easiest)

Download the pre-built Raspberry Pi image from the GitHub Releases page. Flash it to an SD card using Raspberry Pi Imager, boot your Pi, and you’re done — OpenCloudTouch starts automatically.

Option B: Docker Compose 

# Clone the repository
git clone https://github.com/opencloudtouch/opencloudtouch.git
cd opencloudtouch

# Start with Docker Compose
docker compose up -d

The service starts on port 7777 by default.

2. Discover Your Speakers

OpenCloudTouch automatically discovers SoundTouch speakers on your network via SSDP multicast. Open the web UI:

http://<your-host-ip>:7777

Your speakers should appear within a few seconds.

3. Configure Presets & Radio

Use the web interface to:

  • Assign presets (1–6) to your favorite stations
  • Browse and add internet radio stations
  • Create multi-room groups (zones)
  • Control volume and playback

Warning

WSL2 users: Multicast discovery requires networkingMode=mirrored in .wslconfig plus a firewall rule for UDP ports 1900 and 5353. See Network Configuration for details.

What’s Next?

Last updated on
Architecture