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
- Raspberry Pi 5* oder Raspberry Pi 4* mit Raspberry Pi OS
- CUL-Stick 868 MHz* (für HomeMatic-Protokoll) – oder Zigbee-Dongle
- Stabiles Netzteil und schnelle SD-Karte oder NVMe-SSD (für Dauerbetrieb)
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
- Weitere Grundlagen im FHEM Quick-Start Wiki
- Passende Templates für eure Zigbee-Geräte im FHEM-Wiki zu Zigbee2MQTT
- Zeitpläne und Automationen mit
atundnotifyeinrichten
