INSTALLATION en

🇩🇪 Deutsche Version

Installation

OpenCloudTouch can be installed in several ways. Choose the option that best fits your setup.

---

Option 1: Raspberry Pi Image (recommended for beginners)

The easiest method! Flash the ready-made image to an SD card, plug it into your Pi — done.

Supported Models

Image	Architecture	Raspberry Pi Models
opencloudtouch-arm64	64-bit	RPi 3, 4, 5
opencloudtouch-armhf	32-bit	RPi 2, 3 (32-bit)

Download

Download the appropriate image for your Pi from the Releases page:

• RPi 3 / 4 / 5 → opencloudtouch-arm64-*.img.xz
• RPi 2 → opencloudtouch-armhf-*.img.xz

Instructions

1. Download the Raspberry Pi Imager
2. Launch the Imager → Use custom → Select the .img.xz file
3. Optional: Click ⚙️ to pre-configure Wi-Fi and SSH
4. Flash to your SD card
5. Insert the SD card into your Pi and power it on
6. Wait 2-3 minutes (first boot takes a bit longer)
7. Open in your browser: http://opencloudtouch.local:7777

Wi-Fi Configuration (Headless)

To configure Wi-Fi before first boot (instead of Ethernet):

1. After flashing: Open the boot partition of the SD card
2. Edit the file oct-config.txt:

WIFI_SSID=MyNetwork
WIFI_PASSWORD=MyPassword
WIFI_COUNTRY=DE

3. Insert SD card and boot — Wi-Fi will be configured automatically

Default Credentials

User	oct
Password	opencloudtouch
SSH	Enabled
Web UI	http://opencloudtouch.local:7777

⚠️ Please change the password after first login!

passwd

---

Option 2: Docker on Raspberry Pi

For users who already have a Raspberry Pi or want to set one up.

What You Need

• Raspberry Pi 2, 3, 4 or 5 (with at least 1 GB RAM, recommended 2 GB)
• microSD card (≥ 8 GB, recommended 16 GB)
• Power supply (USB-C, 5V/3A)
• Ethernet cable or Wi-Fi connection

Step 1: Install Raspberry Pi OS

1. Download and install the Raspberry Pi Imager
2. Launch the Imager and select:
   • Operating System: Raspberry Pi OS Lite (64-bit) — recommended, no desktop needed
   • Storage: Your microSD card
3. Click the gear icon ⚙️ for advanced settings:
   • Hostname: opencloudtouch
   • Enable SSH: Yes (with password)
   • Username/Password: Choose a secure password
   • Configure Wi-Fi: Your network name (SSID) and password
4. Click Write and wait for the process to complete

Step 2: Boot the Raspberry Pi

1. Insert the microSD card into the Raspberry Pi
2. Connect the power supply
3. Wait 1-2 minutes for the Pi to boot up
4. Find the IP address of your Pi (e.g. via your router or with ping opencloudtouch.local)

Step 3: Connect via SSH

Open a terminal (Windows: PowerShell, Mac: Terminal) and connect:

ssh pi@opencloudtouch.local
# Or with IP address:
ssh pi@192.168.1.xxx

Step 4: Install Docker

On the Raspberry Pi (via SSH):

# Install Docker (official script)
curl -fsSL https://get.docker.com | sh

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and back in (for group membership to take effect)
exit

Log back in:

ssh pi@opencloudtouch.local

Step 5: Start OpenCloudTouch

# Create directory
mkdir -p ~/opencloudtouch && cd ~/opencloudtouch

# Create docker-compose.yml
cat > docker-compose.yml << 'EOF'
version: '3.8'

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
EOF

# Start the container
docker compose up -d

Step 6: Open the Web UI

Open in your browser on your computer or smartphone:

http://opencloudtouch.local:7777

or with the IP address:

http://192.168.1.xxx:7777

🎉 Done! OpenCloudTouch is running. Continue with First Setup.

Auto-Start

The container automatically restarts after a reboot thanks to restart: unless-stopped.

Installing Updates

cd ~/opencloudtouch
docker compose pull
docker compose up -d

---

Option 3: Docker on a NAS

OpenCloudTouch runs on any NAS that supports Docker.

Synology NAS

1. Open the Container Manager package (formerly: Docker)
2. Go to Registry → search for ghcr.io/scheilch/opencloudtouch
3. Download the image ghcr.io/scheilch/opencloudtouch:latest
4. Create a new container:
   • Network: host (important for device discovery!)
   • Volume: /data → assign a local folder
   • Environment Variables:
     • OCT_PORT = 7777
     • OCT_DISCOVERY_ENABLED = true
5. Start the container
6. Open http://<NAS-IP>:7777

TrueNAS / Unraid / Others

docker run -d \
  --name opencloudtouch \
  --network host \
  --restart unless-stopped \
  -v oct-data:/data \
  ghcr.io/scheilch/opencloudtouch:latest

⚠️ Important: --network host is required for OpenCloudTouch to automatically discover SoundTouch devices (SSDP/UPnP multicast). Without it, only manual IP entry works.

---

Option 4: Docker on PC/Laptop

For testing or when no dedicated server is available.

Windows

1. Install Docker Desktop
2. Open PowerShell and run:

docker run -d `
  --name opencloudtouch `
  -p 7777:7777 `
  -v oct-data:/data `
  -e OCT_DISCOVERY_ENABLED=true `
  ghcr.io/scheilch/opencloudtouch:latest

⚠️ On Windows, --network host cannot be used. Use -p 7777:7777 and configure device IPs manually under Settings in the web UI.

3. Open http://localhost:7777

macOS / Linux

docker run -d \
  --name opencloudtouch \
  --network host \
  --restart unless-stopped \
  -v oct-data:/data \
  ghcr.io/scheilch/opencloudtouch:latest

Open http://localhost:7777

---

After Installation

👉 First Setup — Connect your SoundTouch devices with OpenCloudTouch

---

Uninstallation

# Stop and remove container
docker compose down        # or: docker rm -f opencloudtouch

# Delete data (optional)
docker volume rm oct-data

---

Problems with installation? See FAQ or Troubleshooting