FHEM-Weboberfläche im Browser mit Menü und SecurityCheck-Hinweis nach dem ersten Start

FHEM auf dem Raspberry Pi installieren – Anleitung 2026

FHEM ist eine bewährte Open-Source-Hausautomationssoftware, die auf dem Raspberry Pi als stromsparender Dauerbetrieb-Server läuft. In diesem Artikel zeige ich euch die aktuelle Installation auf Raspberry Pi OS sowie die Grundkonfiguration mit CUL-Stick, HomeMatic und MQTT.

Hardware

Mit * markierte Links sind Affiliate-Links, also Werbung. Kauft ihr darüber ein, erhalte ich eine Provision, der Preis bleibt für euch gleich. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Mehr dazu

FHEM installieren

FHEM betreibt ein eigenes Debian-Repository. Die Installation auf Raspberry Pi OS erfolgt so:

# GPG-Schlüssel importieren
sudo apt update && sudo apt install gpg
wget -O- https://debian.fhem.de/archive.key | gpg --dearmor | sudo tee /usr/share/keyrings/debianfhemde-archive-keyring.gpg > /dev/null

# Repository als eigene Quelldatei eintragen
sudo tee /etc/apt/sources.list.d/debianfhemde.sources > /dev/null <<'EOF'
Types: deb
URIs: https://debian.fhem.de/nightly/
Suites: /
Signed-By: /usr/share/keyrings/debianfhemde-archive-keyring.gpg
EOF

# FHEM installieren
sudo apt update && sudo apt install fhem

Die Quelldatei folgt der Installationsanleitung von FHEM. Habt ihr das Repository früher als Zeile in /etc/apt/sources.list eingetragen, löscht diese Zeile, sonst meldet apt update die Quelle doppelt.

FHEM wird nach /opt/fhem/ installiert und startet automatisch als systemd-Dienst. Direkt nach der Installation empfehle ich, nützliche Perl-Abhängigkeiten nachzuinstallieren:

sudo apt install libdevice-serialport-perl libio-socket-ssl-perl libwww-perl \
    libxml-simple-perl libjson-perl libdatetime-format-strptime-perl

Webinterface aufrufen

Das FHEM-Webinterface (FHEMWEB) ist direkt nach der Installation erreichbar:

http://<IP-des-Raspberry-Pi>:8083/fhem

Die IP-Adresse des Pi findet ihr mit hostname -I. Im oberen Bereich des Webinterfaces befindet sich das Kommandofeld – hier werden alle FHEM-Befehle eingegeben. Änderungen werden mit Save config dauerhaft gespeichert.

Ab Werk ist das Webinterface ohne Passwort im ganzen Heimnetz erreichbar, und über das Kommandofeld lässt sich jeder Befehl ausführen. FHEM weist beim Start selbst darauf hin („WEB is not password protected“). Legt deshalb gleich einen Zugang mit Passwort an und ersetzt dabei BENUTZER und PASSWORT durch eure eigenen Daten:

# Im FHEMWEB-Kommandofeld nacheinander eingeben:
define allowed_WEB allowed
attr allowed_WEB validFor WEB
set allowed_WEB basicAuth BENUTZER PASSWORT
save

Ab dann fragt der Browser beim Aufruf nach Benutzername und Passwort. FHEM speichert das Passwort nur als Hash in der Konfiguration.

Optional: Die Standardkonfiguration sucht bei jedem Start nach neuen USB-Geräten. Wenn ihr keine USB-Funkmodule wie einen CUL-Stick anschließt, schaltet ihr diese Suche ab:

# Im FHEMWEB-Kommandofeld eingeben:
attr initialUsbCheck disable 1
save

FHEM aktualisieren

FHEM wird über das integrierte Update-System aktualisiert – einfach im Kommandofeld:

update

CUL-Stick und HomeMatic einrichten

Der CUL-Stick erscheint unter Linux als USB-Seriell-Gerät. Für einen stabilen Gerätepfad nutzt immer den by-id-Pfad:

ls /dev/serial/by-id/

FHEM-Definition im Kommandofeld (Pfad anpassen):

define CUL868 CUL /dev/serial/by-id/usb-FTDI_FT232R_USB_UART_XXXXXXXX-if00-port0@38400 0000
attr CUL868 rfmode HomeMatic
save

Die Zeile mit rfmode ist wichtig: Ab Werk arbeitet ein CUL im Modus SlowRF für FS20 und FHT und empfängt keinen HomeMatic-Funk.

Zum Anlernen schaltet ihr den CUL für 60 Sekunden in den Anlernmodus und drückt in dieser Zeit die Anlerntaste am HomeMatic-Gerät:

set CUL868 hmPairForSec 60

FHEM legt das Gerät danach automatisch an. Eine detaillierte Anleitung zur HomeMatic-Integration findet ihr im FHEM-Wiki.

MQTT einrichten

FHEM bringt mit MQTT2_SERVER einen eigenen MQTT-Broker mit, einen separaten Broker wie Mosquitto braucht ihr nicht. Im Kommandofeld:

define MQTT2_FHEM_Server MQTT2_SERVER 1883
save

So nimmt der Broker nur Verbindungen vom Pi selbst an, das reicht für Zigbee2MQTT auf demselben Pi. Sollen sich auch andere Geräte im Netz verbinden, hängt ihr an die Definition global an. Laut FHEM-Referenz braucht ihr dann eine Anmeldung über ein allowed-Gerät oder das Attribut allowfrom. Läuft auf dem Pi bereits Mosquitto, ist Port 1883 belegt: Entfernt Mosquitto dann mit sudo apt remove mosquitto oder gebt dem FHEM-Broker einen anderen Port.

Zigbee via Zigbee2MQTT (modern)

Für Zigbee-Geräte ist Zigbee2MQTT die empfohlene Methode. Ihr braucht einen Zigbee-Dongle, z.B. den Sonoff Zigbee 3.0 USB Dongle Plus*. Zigbee2MQTT installiert ihr nach der offiziellen Linux-Anleitung. In dessen configuration.yaml tragt ihr den FHEM-Broker und eine feste Client-ID ein:

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://localhost:1883
  client_id: zigbee_pi

Sobald Zigbee2MQTT läuft, legt FHEM die Bridge automatisch als Gerät zigbee_pi an, benannt nach der Client-ID. Mit dem mitgelieferten Template richtet ihr sie ein:

set zigbee_pi attrTemplate zigbee2mqtt_bridge
save

Ab jetzt bekommt jedes Zigbee-Gerät ein eigenes MQTT2_DEVICE, z.B. zigbee_0x00158d0001abcd12, sobald es den ersten Messwert oder Status meldet. Den Anlernmodus für neue Geräte schaltet ihr in der Weboberfläche von Zigbee2MQTT ein oder aus FHEM heraus:

set MQTT2_FHEM_Server publish zigbee2mqtt/bridge/request/permit_join {"time": 254}

Zigbee2MQTT nimmt dann gut vier Minuten lang neue Geräte auf.

Dienst verwalten

# Status prüfen
sudo systemctl status fhem

# Neu starten
sudo systemctl restart fhem

# Logs anzeigen
sudo journalctl -u fhem -f

Nächste Schritte

Ähnliche Beiträge