Homie - Smart-Home-Geräte zentral verwalten

Homie - Smart-Home-Geräte zentral verwalten

Homie ist ein offenes MQTT-Konvention-Framework, das eine einheitliche Schnittstelle für Smart-Home-Geräte und IoT-Sensoren über MQTT definiert.

Was ist Homie?

Die Homie-Konvention legt fest, wie IoT-Geräte ihre Eigenschaften über MQTT ankündigen und kommunizieren sollen. Dadurch können verschiedene Geräte und Plattformen — wie Home Assistant, Node-RED oder OpenHAB — ohne individuelle Konfiguration miteinander interagieren. Der Homie-Server läuft als leichtgewichtiger MQTT-Broker-Companion und ermöglicht eine strukturierte Geräteverwaltung. Besonders nützlich in heterogenen Smart-Home-Umgebungen mit Geräten verschiedener Hersteller.

Voraussetzungen

  • Docker 20.10+ / Docker Compose
  • MQTT-Broker (z. B. Eclipse Mosquitto, im Stack ergänzbar)

Compose-Beispiel

services:
  homie-controller:
    image: ghcr.io/homieiot/homie-controller:latest
    container_name: homie-controller
    restart: unless-stopped
    ports:
      - "8080:8080"
    volumes:
      - ./data:/data
    environment:
      - MQTT_HOST=mosquitto
      - MQTT_PORT=1883
      - TZ=Europe/Berlin
    depends_on:
      - mosquitto

  mosquitto:
    image: eclipse-mosquitto:2
    container_name: mosquitto
    restart: unless-stopped
    ports:
      - "1883:1883"
    volumes:
      - ./mosquitto/config:/mosquitto/config
      - ./mosquitto/data:/mosquitto/data

Hinweise

  • Geräte müssen die Homie-Konvention implementieren, um automatisch erkannt zu werden — viele ESP8266/ESP32-Firmware-Projekte unterstützen dies bereits.
  • Home Assistant erkennt Homie-kompatible Geräte über die MQTT-Integration automatisch.
  • Die Mosquitto-Konfiguration erfordert eine mosquitto.conf mit aktiviertem Listener; das Repository enthält ein Beispiel.
  • Für verschlüsselte Kommunikation sollte MQTT mit TLS und Passwortauthentifizierung konfiguriert werden.