INSTALLATION

🇬🇧 English version

Installation

OpenCloudTouch kann auf verschiedene Arten installiert werden. Wähle die Variante, die am besten zu dir passt.

---

Option 1: Raspberry Pi Image (empfohlen für Einsteiger)

Die einfachste Methode! Du flashst das fertige Image auf eine SD-Karte, steckst sie in deinen Pi — fertig.

Unterstützte Modelle

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

Download

Lade das passende Image für deinen Pi von der Releases-Seite herunter:

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

Anleitung

1. Lade den Raspberry Pi Imager herunter
2. Starte den Imager → Eigenes Image → Wähle die .img.xz Datei
3. Optional: Klicke auf ⚙️ um Wi-Fi und SSH vorzukonfigurieren
4. Flashe auf deine SD-Karte
5. Stecke die SD-Karte in den Pi und starte ihn
6. Warte 2-3 Minuten (erster Start dauert etwas länger)
7. Öffne im Browser: http://opencloudtouch.local:7777

Wi-Fi konfigurieren (ohne Monitor)

Wenn du Wi-Fi vorab konfigurieren möchtest (statt Ethernet):

1. Nach dem Flashen: Öffne die boot-Partition der SD-Karte
2. Bearbeite die Datei oct-config.txt:

WIFI_SSID=MeinNetzwerk
WIFI_PASSWORD=MeinPasswort
WIFI_COUNTRY=DE

3. SD-Karte einlegen und starten — Wi-Fi wird automatisch konfiguriert

Standard-Zugangsdaten

Benutzer	oct
Passwort	opencloudtouch
SSH	Aktiviert
Web-UI	http://opencloudtouch.local:7777

⚠️ Bitte ändere das Passwort nach dem ersten Login!

passwd

---

Option 2: Docker auf Raspberry Pi

Für Nutzer, die bereits einen Raspberry Pi haben oder einen einrichten möchten.

Was du brauchst

• Raspberry Pi 2, 3, 4 oder 5 (mit mindestens 1 GB RAM, empfohlen 2 GB)
• microSD-Karte (≥ 8 GB, empfohlen 16 GB)
• Netzteil (USB-C, 5V/3A)
• Netzwerkkabel oder Wi-Fi-Verbindung

Schritt 1: Raspberry Pi OS installieren

1. Lade den Raspberry Pi Imager herunter und installiere ihn
2. Starte den Imager und wähle:
   • Betriebssystem: Raspberry Pi OS Lite (64-bit) — empfohlen, da keine Desktopumgebung nötig
   • Speichermedium: Deine microSD-Karte
3. Klicke auf das Zahnrad ⚙️ für erweiterte Einstellungen:
   • Hostname: opencloudtouch
   • SSH aktivieren: Ja (mit Passwort)
   • Benutzername/Passwort: Wähle ein sicheres Passwort
   • Wi-Fi konfigurieren: Dein Netzwerkname (SSID) und Passwort
4. Klicke auf Schreiben und warte bis der Vorgang abgeschlossen ist

Schritt 2: Raspberry Pi starten

1. Stecke die microSD-Karte in den Raspberry Pi
2. Verbinde das Netzteil
3. Warte 1-2 Minuten bis der Pi hochgefahren ist
4. Finde die IP-Adresse deines Pi (z.B. über deinen Router oder mit ping opencloudtouch.local)

Schritt 3: Per SSH verbinden

Öffne ein Terminal (Windows: PowerShell, Mac: Terminal) und verbinde dich:

ssh pi@opencloudtouch.local
# Oder mit IP-Adresse:
ssh pi@192.168.1.xxx

Schritt 4: Docker installieren

Auf dem Raspberry Pi (per SSH):

# Docker installieren (offizielles Script)
curl -fsSL https://get.docker.com | sh

# Deinen Benutzer zur Docker-Gruppe hinzufügen
sudo usermod -aG docker $USER

# Ausloggen und neu einloggen (damit die Gruppenmitgliedschaft wirkt)
exit

Logge dich erneut ein:

ssh pi@opencloudtouch.local

Schritt 5: OpenCloudTouch starten

# Verzeichnis erstellen
mkdir -p ~/opencloudtouch && cd ~/opencloudtouch

# docker-compose.yml erstellen
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

# Container starten
docker compose up -d

Schritt 6: Web-UI öffnen

Öffne im Browser auf deinem Computer oder Smartphone:

http://opencloudtouch.local:7777

oder mit der IP-Adresse:

http://192.168.1.xxx:7777

🎉 Geschafft! OpenCloudTouch läuft. Weiter mit der Ersteinrichtung.

Autostart einrichten

Der Container startet dank restart: unless-stopped automatisch nach einem Neustart des Pi.

Updates installieren

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

---

Option 3: Docker auf einem NAS

OpenCloudTouch läuft auf jedem NAS, das Docker unterstützt.

Synology NAS

1. Öffne das Container Manager Paket (früher: Docker)
2. Gehe zu Registry → suche ghcr.io/scheilch/opencloudtouch
3. Lade das Image ghcr.io/scheilch/opencloudtouch:latest herunter
4. Erstelle einen neuen Container:
   • Netzwerk: host (wichtig für Geräteerkennung!)
   • Volume: /data → einen lokalen Ordner zuweisen
   • Umgebungsvariablen:
     • OCT_PORT = 7777
     • OCT_DISCOVERY_ENABLED = true
5. Container starten
6. Öffne http://<NAS-IP>:7777

TrueNAS / Unraid / Andere

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

⚠️ Wichtig: --network host ist erforderlich, damit OpenCloudTouch SoundTouch-Geräte automatisch finden kann (SSDP/UPnP Multicast). Ohne funktioniert nur die manuelle IP-Eingabe.

---

Option 4: Docker auf PC/Laptop

Für Tests oder wenn kein dedizierter Server verfügbar ist.

Windows

1. Installiere Docker Desktop
2. Öffne PowerShell und führe aus:

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

⚠️ Unter Windows kann --network host nicht verwendet werden. Nutze -p 7777:7777 und konfiguriere Geräte-IPs manuell unter Einstellungen in der Web-UI.

3. Öffne http://localhost:7777

macOS / Linux

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

Öffne http://localhost:7777

---

Nach der Installation

👉 Ersteinrichtung — SoundTouch-Geräte mit OpenCloudTouch verbinden

---

Deinstallation

# Container stoppen und entfernen
docker compose down        # oder: docker rm -f opencloudtouch

# Daten löschen (optional)
docker volume rm oct-data

---

Probleme bei der Installation? Siehe FAQ oder Fehlerbehebung