Raspberry Pi ESPHome

Passende Hardware im Überblick

Der Pi als ESPHome-Server:
Raspberry Pi 5 mit 8GB RAM – die Empfehlung für Home Assistant plus ESPHome (Link)*
Raspberry Pi 5 mit 16GB RAM – wenn viele Dienste dazukommen (Link)*
Raspberry Pi 5 mit 4GB RAM – reicht knapp, kompiliert aber langsamer (Link)*
Raspberry Pi 4 Starter-Set – wenn es günstig sein soll (Link)*
Home Assistant Green – die fertige Zentrale ohne Bastelarbeit (Link)*

ESP-Boards, die ESPHome bespielt:
ELEGOO ESP32 im 3er-Pack – der Klassiker zum Einstieg (Link)*
ESP32-C6 im 2er-Pack – neuer Chip mit Thread und Zigbee-Funk (Link)*
ESP32-CAM mit USB-Programmierboard – Kamera-Knoten fürs Smart Home (Link)*
USB-TTL-Kabel mit FTDI-Chip – für Boards ohne eigenen USB-Anschluss (Link)*
Breadboard-Set mit Netzteil – zum Aufbau ohne Löten (Link)*

Sensoren für die erste Konfiguration:
DS18B20 Temperaturfühler, 5 Stück mit 3m Kabel (Link)*
37-Sensoren-Kit – Bewegung, Licht, Reed-Kontakt in einer Box (Link)*
Sensirion SCD40 – echter CO2-Sensor per I2C (Link)*
MH-Z19B CO2-Sensor – die günstigere Alternative (Link)*
WS2812B LED-Streifen 5m – Statusanzeige und Ambientelicht (Link)*

Fertig kaufen statt selbst bauen:
Shelly 1 Mini Gen3 – Unterputz-Relais mit ESP32 im Inneren (Link)*
Shelly Plug S Gen3 – messende Steckdose zum Einstecken (Link)*

Kurz gesagt: Was bringt ESPHome auf dem Raspberry Pi?

Die Kurzfassung:

• Kein Programmieren: Mit ESPHome auf dem Raspberry Pi beschreibst du in einer Textdatei, welcher Sensor an welchem Pin hängt. Die fertige Firmware für den ESP32 oder ESP8266 baut ESPHome daraus selbst.
• Der Pi ist die Werkstatt: Er beherbergt das Web-Dashboard, kompiliert die Firmware und verteilt Updates ins WLAN. Die Mikrocontroller selbst kosten je nach Modell nur wenige Euro.
• Zwei Wege zur Installation: Als Add-on innerhalb von Home Assistant mit zwei Klicks – oder als Docker-Container, wenn auf dem Pi ein normales Raspberry Pi OS läuft.
• Einmal Kabel, danach Funk: Nur der allererste Flash-Vorgang braucht ein USB-Kabel. Jede spätere Änderung geht drahtlos über das Netzwerk.
• Automatische Übernahme: Ein fertiges Gerät meldet sich von allein bei Home Assistant. Jeder Sensor erscheint als eigene Entität, ohne dass du etwas eintragen musst.
• Ehrliche Grenze: Jede Änderung bedeutet einen neuen Kompilierlauf. Das dauert auf einem Pi 4 spürbar länger als auf einem Pi 5.

Was ESPHome ist – und welche Rolle der Raspberry Pi spielt

Ein ESP32 ist ein Mikrocontroller mit WLAN und Bluetooth, groß wie ein Kaugummistreifen und für kleines Geld zu haben. Wer ihn klassisch nutzen will, schreibt C++-Code in der Arduino-Umgebung: WLAN aufbauen, Sensor auslesen, Werte verschicken, Verbindungsabbrüche abfangen. Das ist genau die Hürde, an der die meisten Bastelprojekte scheitern.

ESPHome dreht das um. Statt Code schreibst du eine Konfigurationsdatei im YAML-Format – eine schlichte Textdatei mit Einrückungen. Darin steht, welches Board du verwendest, in welches WLAN es soll und welcher Sensor an welchem Pin hängt. ESPHome übersetzt das in fertige Firmware, inklusive allem Drumherum: Verbindungsaufbau, Neuversuch bei Funkabriss, Update-Funktion, Protokollausgabe.

Die Arbeitsteilung ist klar: Der Raspberry Pi ist der Server. Auf ihm läuft das Dashboard im Browser, dort liegen alle Konfigurationsdateien, und er kompiliert die Firmware und schiebt sie über das Netzwerk auf die Geräte. Die ESP-Boards sind die Außenposten – am Fenster, im Heizungskeller, im Sicherungskasten. Fällt der Pi aus, laufen sie trotzdem weiter; sie brauchen ihn nur zum Bauen und Aktualisieren.

Seit ESPHome 2026.6 heißt die Oberfläche ESPHome Device Builder und hat das alte Dashboard abgelöst. Sie bringt einen Editor mit Syntaxprüfung, einen Katalog aller Komponenten und eine Pin-Übersicht je Board mit – für Einsteiger ein spürbarer Gewinn, weil Tippfehler auffallen, bevor der Kompilierlauf startet.

ESPHome auf dem Raspberry Pi installieren – Schritt für Schritt

Der einfachste Weg führt über Home Assistant. Läuft auf dem Pi dagegen ein normales Raspberry Pi OS, nimmst du den Container – beides führt zur selben Oberfläche auf Port 6052.

1. Grundlage schaffen: Ein Pi 4 oder besser ein Raspberry Pi 5 mit mindestens 4 GB RAM. Das Kompilieren ist rechenintensiv und schreibt viel – eine SSD statt der Speicherkarte ist hier keine Feinheit, sondern spart Wartezeit und verlängert die Lebensdauer.
2. Variante A – als Add-on: In Home Assistant auf Einstellungen > Add-ons > Add-on Store gehen, nach ESPHome suchen, installieren, Im Seitenmenü anzeigen aktivieren und starten. Fertig.
3. Variante B – als Container: Auf einem Pi mit Docker legst du einen Ordner an und darin eine compose.yaml mit dem Image ghcr.io/esphome/esphome, dem Eintrag network_mode: host und dem Ordner als Volume unter /config. Gestartet wird mit docker compose up -d. Das host-Netzwerk ist Pflicht: Nur so findet ESPHome die Geräte per mDNS – sonst stehen im Dashboard lauter Knoten auf „offline", obwohl sie längst laufen.
4. Dashboard öffnen: Im Browser http://raspberrypi.local:6052 aufrufen. Kennst du die Adresse nicht, hilft die Anleitung zur IP-Adresse des Pi.
5. Erstes Gerät anlegen: Auf New Device klicken, Namen vergeben, WLAN-Zugangsdaten eintragen, Board-Typ auswählen. ESPHome erzeugt daraus eine Startkonfiguration samt Verschlüsselungsschlüssel für Home Assistant.
6. Erstmalig flashen: ESP-Board per USB an den Pi stecken, im Dashboard Install > Plug into this computer wählen. Der erste Lauf dauert einige Minuten, weil die Toolchain geladen wird. Danach hängt das Gerät im WLAN.

Die YAML-Konfiguration verstehen – Aufbau einer Gerätedatei

Jedes Gerät hat genau eine Datei. Ihr Kopf ist bei allen Geräten fast identisch und beschreibt Name, Chip, Funk und Fernwartung:

esphome:
  name: wohnzimmer-klima
esp32:
  board: esp32dev
wifi:
  ssid: !secret wlan_ssid
  password: !secret wlan_passwort
api:
  encryption:
    key: !secret api_key
ota:
  - platform: esphome
logger:

Der Block api ist die direkte Leitung zu Home Assistant. Seit Version 2026.1 ist die alte Passwort-Anmeldung ersatzlos entfallen – es gibt nur noch den verschlüsselten Weg über encryption: key. Auch OTA-Updates verlangen zwingend SHA256.

Wichtig ist die Schreibweise !secret. Damit steht das WLAN-Passwort nicht in der Gerätedatei, sondern zentral in der secrets.yaml im selben Verzeichnis. Das hat zwei Vorteile: Du kannst Konfigurationen gefahrlos im Forum zeigen, und beim Routerwechsel änderst du das Passwort an einer Stelle statt in zwanzig Dateien.

Darunter folgen die eigentlichen Bausteine. Ein DHT22 für Temperatur und Luftfeuchte sieht so aus:

sensor:
  - platform: dht
    pin: GPIO4
    model: DHT22
    temperature:
      name: "Wohnzimmer Temperatur"
    humidity:
      name: "Wohnzimmer Luftfeuchte"
    update_interval: 60s

Mehr braucht es nicht. Nach Install > Wirelessly landet die neue Firmware über das WLAN auf dem Board, und Home Assistant zeigt kurz darauf zwei neue Entitäten an – Namen und Einheiten übernimmt es direkt aus der Konfiguration.

Sensoren, Taster und Displays einbinden

Der Komponentenkatalog ist der eigentliche Schatz von ESPHome: Für die allermeisten gängigen Bauteile existiert eine fertige Plattform, sodass ein neues Messgerät meist fünf bis zehn Zeilen kostet.

• Temperatur und Luftfeuchte: DHT22 und der genauere BME280 sind Standard, für Kabelstrecken eignet sich der DS18B20 per dallas-Bus. Die Grundlagen dazu erklärt die Übersicht zum Temperatursensor.
• Luftqualität: Ein SCD40 hängt per I2C am Bus und liefert echte CO2-Werte statt geschätzter. Passende Bauteile und Alternativen zeigt der Artikel zum CO2-Sensor.
• Bewegung und Präsenz: Ein PIR-Melder wird als binary_sensor mit platform: gpio eingebunden. mmWave-Radarmodule melden zusätzlich ruhende Personen – der Vergleich der Technik steht im Beitrag zum Bewegungsmelder.
• Türen und Fenster: Ein Reed-Kontakt an einem GPIO mit device_class: door genügt. Ein einziger ESP32 kann so ein Dutzend Kontakte im Sicherungskasten bündeln.
• Strom- und Wasserzähler: Die Plattform pulse_meter zählt Impulse eines Reed-Kontakts am Wasserzähler, für moderne Zähler gibt es Lesekopf-Komponenten – Details im Beitrag zum Smartmeter.
• Taster und Relais: Ein binary_sensor als Eingang, ein switch mit platform: gpio als Ausgang – damit steuert das Gerät eine Lampe auch dann, wenn das Netzwerk gerade weg ist.
• Anzeigen: Kleine OLED- oder E-Paper-Module werden über die display-Komponente angesprochen und können Werte direkt aus Home Assistant zurückholen, etwa den Strompreis oder den nächsten Abfuhrtermin.

Welche Nummer welcher Pin ist, verrät die Pin-Ansicht im Device Builder; die allgemeine Systematik erklärt das GPIO-Pinout. Wer LEDs ansteuern will, findet in WLED auf dem ESP32 die spezialisierte Alternative, und für Kameraknoten lohnt der Blick auf die ESP32-CAM.

ESPHome oder Tasmota – was passt wofür?

Beide Projekte machen aus ESP-Chips lokal steuerbare Smart-Home-Geräte, gehen aber grundverschieden vor. Tasmota ist eine fertige Firmware, die man aufspielt und danach im Browser konfiguriert. ESPHome baut für jedes Gerät eine maßgeschneiderte Firmware.

Die Faustregel lautet: Wer selbst lötet und Home Assistant nutzt, fährt mit ESPHome besser. Wer nur eine gekaufte Steckdose aus der Hersteller-Cloud befreien will, kommt mit Tasmota schneller ans Ziel. Umflashbar sind vor allem Geräte von Sonoff, viele NOUS- und Athom-Steckdosen sowie diverse LED-Controller. Bei Shelly-Geräten lohnt der Aufwand selten – sie sprechen bereits ab Werk lokal und lassen sich ohne Umbau einbinden. Tuya-Geräte aus dem Handel sind seit Jahren gegen das drahtlose Umflashen abgesichert; dort führt nur noch der Weg über aufgelötete Kabel.

Stromversorgung und Deep Sleep für den Batteriebetrieb

Ein ESP32 mit dauerhaft aktivem WLAN zieht grob 80 bis 160 Milliampere. An einem kleinen Akku ist damit nach ein bis zwei Tagen Schluss – für einen Briefkastensensor oder einen Fühler im Gartenhaus ist das nichts. Die Lösung heißt Deep Sleep: Das Gerät wacht auf, misst, sendet und schläft wieder ein. Im Schlaf sinkt die Aufnahme in den Bereich einiger Mikroampere.

In der YAML sind das drei Zeilen mit deep_sleep:, run_duration und sleep_duration. Erfahrungswerte aus der Community: 15 bis 20 Sekunden Laufzeit reichen meist für Verbindungsaufbau, Messung und Übertragung; bei einem Messintervall von zehn Minuten sind Laufzeiten von mehreren Monaten realistisch.

Der Haken ist bekannt und trifft jeden früher oder später: Ein schlafendes Gerät nimmt keine Funk-Updates an. Wer nach dem Einschlafen etwas ändern will, hat keine Chance, das Zeitfenster zu erwischen. Deshalb gehört in jede Batteriekonfiguration ein Notausgang – üblich ist ein Schalter in Home Assistant, der über deep_sleep.prevent das nächste Einschlafen verhindert. Das Gerät bleibt dann nach dem nächsten Aufwachen wach, das Update läuft durch, danach wird der Schalter zurückgesetzt. Alternativ hält ein Taster am Reset-Pin die gleiche Tür offen. Wer dieses Detail vergisst, holt das Gerät zum Ändern von der Wand und schließt es per Kabel an.

Für alles, was fest verbaut ist, gilt der umgekehrte Rat: dauerhaft am Netzteil betreiben und auf Deep Sleep verzichten. Ein sauberes USB-Netzteil verhindert die häufigsten Sporadikfehler – Boards, die beim WLAN-Aufbau kurzzeitig deutlich mehr Strom ziehen und an schwachen Ladegeräten immer wieder neu starten.

Typische Fehler und Stolpersteine bei ESPHome

• Falsches Board ausgewählt: Ein ESP32-C3 oder C6 ist kein klassischer ESP32. Steht in der Konfiguration der falsche Board-Typ, kompiliert alles anstandslos – das Gerät bootet danach aber in einer Endlosschleife oder bleibt stumm.
• Pins verwechselt: Nicht jeder GPIO taugt für jeden Zweck. Einige Pins müssen beim Start auf einem bestimmten Pegel liegen, andere sind fest belegt. Sensoren an solchen Pins führen zu Boot-Schleifen, die man leicht dem Sensor selbst anlastet.
• WLAN-Passwort im Klartext: Wer die Zugangsdaten direkt in die Gerätedatei schreibt, verteilt sie beim nächsten Forenbeitrag oder Backup gleich mit. Alles Vertrauliche gehört in die secrets.yaml.
• Nach dem Update nicht mehr erreichbar: Meist ist der Gerätename oder die WLAN-Konfiguration schuld. ESPHome legt für solche Fälle ein Rückfallnetz an – nach mehreren gescheiterten Verbindungsversuchen öffnet das Board einen eigenen Hotspot, über den man es im Browser wieder gerade rücken kann.
• Alte Firmware, neue Regeln: Geräte mit Firmware vor 2025.10 lassen sich wegen der Umstellung auf SHA256 nicht mehr drahtlos aktualisieren. Der Zwischenschritt über eine ältere Version oder ein Kabel-Flash bleibt dann nicht erspart.
• Kompilieren dauert ewig: Auf einem Pi 4 mit Speicherkarte kann der erste Bau zehn Minuten und mehr verschlingen. Eine SSD und ausreichend Swap verhindern, dass der Vorgang mit Speichermangel abbricht.
• Kein Backup der YAML-Dateien: Die Firmware auf dem Chip lässt sich nicht zurückverwandeln. Geht der Konfigurationsordner verloren, beginnt jedes Gerät wieder bei null – ein Backup ist daher Pflicht.

Häufige Fragen zu ESPHome auf dem Raspberry Pi

Brauche ich Home Assistant, um ESPHome zu nutzen?
Nein. ESPHome läuft als eigenständiger Docker-Container auf jedem Pi, und die Geräte können ihre Werte auch per MQTT oder über eine eigene Weboberfläche ausgeben. Der volle Komfort mit automatischer Geräteerkennung entsteht aber erst im Zusammenspiel mit Home Assistant.

Läuft der ESPHome-Server auf einem Pi Zero 2 W?
Technisch ja, praktisch mühsam. Das Kompilieren belegt viel Arbeitsspeicher und dauert auf dem Zero 2 W ein Vielfaches. Für regelmäßiges Arbeiten sind mindestens 4 GB RAM zu empfehlen.

Funktioniert ESPHome auch mit dem Raspberry Pi Pico W?
Der Pico mit RP2040 wird von ESPHome unterstützt, allerdings ist die Auswahl an Komponenten deutlich kleiner als beim ESP32. Für neue Projekte ist ein ESP32 die verlässlichere Wahl.

Muss der Raspberry Pi rund um die Uhr laufen?
Nur für Kompilieren und Aktualisieren. Die geflashten Geräte arbeiten unabhängig weiter. Wer sie in Automatisierungen einbindet, braucht die Zentrale aber ohnehin dauerhaft – siehe die Beispiele zu Automatisierungen.

Wie viele ESP-Geräte verkraftet ein Pi?
Die Zahl ist praktisch unbegrenzt, weil der Pi nur beim Bauen arbeitet. Berichte aus der Community nennen Installationen mit über fünfzig Knoten an einer einzigen Zentrale. Die Grenze setzt eher das WLAN als der Pi.

Kann ich gekaufte Steckdosen mit ESPHome umflashen?
Bei Sonoff-, Athom- und vielen NOUS-Geräten gelingt das, oft sogar drahtlos oder über wenige Lötpunkte. Tuya-Geräte sind seit Jahren abgesichert und verlangen den Weg über den Serial-Anschluss im Inneren.

Was passiert, wenn das WLAN ausfällt?
Das Gerät versucht selbstständig, die Verbindung wiederherzustellen. Automatisierungen, die direkt auf dem Chip hinterlegt sind – etwa Taster schaltet Relais – funktionieren auch ohne Netz weiter. Alles, was über Home Assistant läuft, pausiert bis zur Rückkehr des Funks.

Fazit

ESPHome auf dem Raspberry Pi ist der kürzeste Weg vom Bauteil zum fertigen Smart-Home-Gerät – und die ehrlichste Antwort auf die Frage, warum man einen Sensor für 4 Euro nicht als Fertigprodukt für 40 Euro kaufen sollte. Unsere klare Empfehlung: Fang mit einem einzigen ESP32 und einem Temperatursensor an, bevor du zehn Boards bestellst. Wer den Ablauf einmal durchlaufen hat – Datei anlegen, per USB flashen, in Home Assistant sehen, drahtlos nachbessern –, hat den schwierigsten Teil hinter sich; alles Weitere sind Varianten desselben Musters. Zwei Dinge solltest du von Anfang an richtig machen: Zugangsdaten gehören in die secrets.yaml, und der Konfigurationsordner gehört in ein Backup. Und wenn Batteriebetrieb geplant ist, baue den Notausgang gegen den Deep Sleep gleich mit ein – nachrüsten lässt er sich nur mit dem Schraubenzieher in der Hand.

* = Affiliate Link (raspi-config.de ist Teilnehmer des Partnerprogramms von Amazon EU, das zur Bereitstellung eines Mediums für Websites konzipiert wurde, mittels dessen durch die Platzierung von Werbeanzeigen und Links zu Amazon.de Werbekostenerstattung verdient werden kann.)