Skip to content

Installation

Jump to bottom
bausi2k edited this page Jan 29, 2026 · 4 revisions

Installation

Die Bridge wird als Docker-Container bereitgestellt. Das ist der sicherste und einfachste Weg.

Voraussetzungen

  • Ein Server mit Docker & Docker Compose (z.B. Raspberry Pi, Synology NAS, Unraid, Linux VM).
  • Eine Philips Hue Bridge (eckiges Modell V2).
  • Einen Loxone Miniserver.

Variante A: Docker (Empfohlen) 🐳

Schritt 1: Ordner erstellen

Erstelle auf deinem Server einen Ordner, z.B. loxhuebridge.

Schritt 2: docker-compose.yml

Erstelle in diesem Ordner eine Datei docker-compose.yml mit folgendem Inhalt:

services:
  loxhuebridge:
    image: ghcr.io/bausi2k/loxhuebridge:latest
    container_name: loxhuebridge
    restart: always
    # WICHTIG für Linux/Raspberry Pi: Host Mode für korrekte UDP Kommunikation
    network_mode: "host"
    environment:
      - TZ=Europe/Vienna
    volumes:
      # Hier werden deine Einstellungen und die Datenbank gespeichert
      - ./data:/app/data

Schritt 3: Starten

Führe im Terminal in diesem Ordner aus:

docker compose up -d

Variante B: Manuelle Installation (Experten) 🤓

Falls du kein Docker nutzen möchtest, benötigst du zwingend Node.js 24 (LTS) oder neuer, da wir das native SQLite-Modul nutzen.

git clone [https://github.com/bausi2k/loxhuebridge.git](https://github.com/bausi2k/loxhuebridge.git)
cd loxhuebridge
npm install
node server.js

💻 Spezialfall: Mac & Windows (Docker Desktop)

Der network_mode: "host" funktioniert unter macOS und Windows Docker Desktop oft nicht korrekt.

Lösung für lokale Tests: Nutze ports: - "8555:8555" statt network_mode: "host". Beachte, dass UDP-Rückmeldungen an Loxone in diesem Modus durch Firewalls blockiert sein könnten. Für den Produktivbetrieb empfehlen wir Linux/Raspberry Pi.

Weiter geht's hier

Clone this wiki locally