Docker

Eine Anleitung zur Installation von CUBE OS mit Docker auf Linux-Systemen.

Installieren Sie CUBE OS als Docker-Container auf einem Linux-Host. Diese Methode eignet sich gut für Heimserver, NAS-Geräte und dauerhaft eingeschaltete Linux-Maschinen.

Die Docker-Bereitstellung wird unterstützt auf Nur Linux.

Wenn Sie keinen Linux-Host haben, verwenden Sie Raspberry Pi oder Virtuelle Maschine.

1. Vorbereitung

1

Überprüfen Sie die Host-Architektur

CUBE Docker unterstützt diese Linux-Architekturen:

• amd64 (x86_64) — PCs, Server, Synology-NAS und ähnliche Geräte

• arm64 (aarch64) — Raspberry Pi 4/5, Orange Pi und andere ARM-Hosts

2

Überprüfen Sie die Linux-Kernel-Version

Kernel 4.15 oder neuer ist erforderlich.

uname -r

Einige NAS-Geräte werden mit älteren Kernel-Versionen ausgeliefert, wie z. B. 4.4.x. Diese Hosts sind nicht mit CUBE Docker kompatibel. Führen Sie in diesem Fall stattdessen CUBE OS in einer Linux-VM aus.

3

Docker Engine installieren

Installieren Sie Docker Engine auf dem Host, bevor Sie fortfahren.

Verwenden Sie die offizielle Docker-Installationsanleitung.

4

Überprüfen Sie die erforderlichen Ports

Stellen Sie sicher, dass die Ports 80 und 1883 auf dem Host frei sind.

sudo lsof -i :80
sudo lsof -i :1883

• 80 — CUBE OS-Weboberfläche

• 1883 — MQTT-Broker

Wenn ein anderer Dienst diese Ports verwendet, stoppen Sie ihn zuerst.

5

Bereiten Sie bei Bedarf einen Zigbee-Dongle vor

Wenn Sie Zigbee-Geräte hinzufügen möchten, schließen Sie einen kompatiblen Zigbee-Dongle an den Host an.

Zu den getesteten Zigbee-Dongles gehören:

SONOFF ZBDongle-MAX SONOFF ZBDongle-PMG24 SONOFF ZBDongle-LMG21 SONOFF ZBDongle-E SONOFF ZBDongle-P Andere aufgeführt vom Entwickler @darkxst

Für weitere Informationen zu Zigbee-Konfigurationen und Kompatibilität lesen Sie bitte dies Handbuch.

Weitere Informationen zur Zigbee-Unterstützung finden Sie in dieser Anleitung.

2. Image abrufen

1

Laden Sie das neueste Image herunter

docker pull ghcr.io/ewelinkcube/cube-os:latest

Sie können latest durch ein bestimmtes Versions-Tag ersetzen, z. B. 2.10.3. Verfügbare Versionen sind auf GitHub Releases.

3. CUBE OS starten

1

Erstellen Sie ein Datenverzeichnis

mkdir -p ~/cubeos-data

In diesem Verzeichnis werden Ihre Geräte, Szenen und Einstellungen gespeichert.

2

Überprüfen Sie den Zigbee-Gerätepfad, falls Sie einen verwenden(optional)

Gängige Gerätepfade sind:

ls /dev/ttyUSB* /dev/ttyACM*

Verwenden Sie im nächsten Befehl den richtigen Pfad.

3

Starten Sie den Container

Verwenden Sie diesen Befehl als Grundlage:

docker run -d \
  --name cubeos \
  --privileged \
  --net=host \
  -v ~/cubeos-data:/data \
  --device /dev/ttyUSB0:/dev/ttyUSB0 \
  -v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro \
  ghcr.io/ewelinkcube/cube-os:latest

Wenn Sie kein Zigbee verwenden, entfernen Sie --device /dev/ttyUSB0:/dev/ttyUSB0.

Wenn Sie Matter Hub oder eWeLink Remote nicht verwenden, können Sie auch das D-Bus-Mount entfernen.

4

Verstehen Sie die wichtigsten Parameter

• --privileged — für den Hardwarezugriff erforderlich

• --net=host — erforderlich für LAN-Erkennung und MQTT

• -v ~/cubeos-data:/data — speichert Ihre Daten nach Container-Neustarts

• --device /dev/ttyUSB0:/dev/ttyUSB0 — reicht einen Zigbee-Dongle durch

• -v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro — ermöglicht D-Bus-Zugriff für unterstützte Funktionen

4. Zugriff auf CUBE OS

1

Bestätigen Sie, dass der Container läuft

docker ps

Der Containerstatus sollte Up.

2

Öffnen Sie die Weboberfläche

Öffnen Sie einen Browser im selben Netzwerk und rufen Sie eine dieser Adressen auf:

• http://<HOST_IP>/

• http://cube.local

Ersetzen Sie <HOST_IP> durch die IP-Adresse des Linux-Hosts.

3

Verwenden Sie später die kurze lokale Adresse

Nach der Einrichtung finden Sie die kurze ID auf der Einstellungsseite.

Danach können Sie cube-{short-id}.local verwenden, um diese CUBE OS-Instanz in Ihrem LAN zu identifizieren.

5. CUBE OS aktualisieren

Die Docker-Bereitstellung unterstützt keine OTA-Updates über die Weboberfläche.

Zum manuellen Aktualisieren:

docker stop cubeos
docker rm cubeos
docker pull ghcr.io/ewelinkcube/cube-os:latest

docker run -d \
  --name cubeos \
  --privileged \
  --net=host \
  -v ~/cubeos-data:/data \
  --device /dev/ttyUSB0:/dev/ttyUSB0 \
  -v /run/dbus/system_bus_socket:/host_dbus/system_bus_socket:ro \
  ghcr.io/ewelinkcube/cube-os:latest

Ihre Daten bleiben in ~/cubeos-data, sodass Geräte, Szenen und Einstellungen nach dem Update erhalten bleiben.

6. Einschränkungen

Aufgrund der Container-Isolation sind diese Funktionen in Docker-Bereitstellungen nicht verfügbar:

• Add-ons — Add-ons können nicht installiert oder verwaltet werden

• Bluetooth-Lautsprecher — Bluetooth-Durchleitung wird nicht unterstützt

• Systemupdate — OTA-Updates in der Weboberfläche sind deaktiviert

• Neustart / Herunterfahren — Stromsteuerungen auf Systemebene sind nicht verfügbar

7. Hinweis zu Raspberry Pi

Wenn Sie Docker auf einem Raspberry Pi ausführen, stellen Sie sicher, dass die Seitengröße 4096:

getconf PAGE_SIZE

# Wenn das Ergebnis nicht 4096 ist, fügen Sie diese Zeile hinzu und starten Sie neu
echo "kernel=kernel8.img" | sudo tee -a /boot/firmware/config.txt
sudo reboot