Was ist ESPHome? ESP32 & ESP8266 mit Home Assistant einrichten – Grundlagen für Anfänger

Du wolltest schon immer mal wissen, was ESPHome und diese ESP32 oder 8266 Chips sind, aber warst von allen Videos immer nur verwirrter als vorher?

Hier erkläre ich dir in einfachen Worten, was ESPHome ist, was du zum Start wirklich brauchst und wie du dein erstes Gerät mit Home Assistant verbindest – von der Installation der App bis zum ersten Flashen 🙌

Hinweis (Stand Oktober 2026): Das Video ist von 2023. Die Hardware-Grundlagen darin stimmen weiterhin, die Oberfläche von ESPHome sieht inzwischen aber anders aus. Die Einrichtung und den Beispiel-Code findest du hier im Beitrag deshalb auf dem aktuellen Stand.

Was ist ESPHome?

ESPHome ist eine kostenlose Open-Source-Firmware für Mikrocontroller wie den ESP32 oder ESP8266. Statt selbst zu programmieren, beschreibst du in einer YAML-Datei, was an deinem Board hängt – zum Beispiel ein Temperatursensor, ein Relais oder eine LED. ESPHome baut daraus die passende Firmware und spielt sie auf das Board.

Danach spricht das Gerät über die native API direkt mit Home Assistant, ganz lokal und ohne Cloud. Alle Sensoren und Schalter tauchen automatisch als Entitäten auf, und spätere Änderungen spielst du einfach per WLAN auf.

Für den Einstieg sind ESP32 und ESP8266 die wichtigsten Chips, und um die geht es in diesem Beitrag. ESPHome kann inzwischen aber deutlich mehr: Neben neueren ESP32-Varianten wie ESP32-C3, ESP32-S3 oder ESP32-C6 werden auch der RP2040/RP2350 von Raspberry Pi sowie Chips von Beken (BK72xx), Realtek (RTL87xx), LN882 und Nordic (nRF52) unterstützt. Letztere stecken häufig in fertigen smarten Steckdosen und Lampen.

Voraussetzungen

Home Assistant muss bereits installiert sein, auf welcher Hardware spielt keine Rolle. Für die bequemste Variante mit der ESPHome-App direkt in Home Assistant brauchst du Home Assistant OS, denn nur dort gibt es den Bereich Apps.

Hardware Empfehlungen für deine Home Assistant OS Installation

Falls du gerade erst mit Home Assistant anfängst, schau dir auch meinen Home Assistant Starter Guide an.

Ressourcen

• esphome Doku-Seite
• ESPHome installieren (offizielle Anleitung)
• ESPHome-Integration in der Home-Assistant-Doku

Vokabeln zu ESP32 oder 8266 Boards

Um etwas der Verwirrung vorzubeugen, wenn du selber bei Amazon auf die Jagd gehst, hier mal einige Infos in kompakter Form.

Chip

Das erste Unterscheidungsmerkmal ist der Chip (bestimmt sowohl Leistung als auch Fähigkeiten sowie WLAN-Eigenschaften). Für den Einstieg sind vor allem diese beiden interessant:

• Der ESP32 ist leistungsfähiger (der klassische ESP32 hat 2 CPU-Kerne) und der Chip beherrscht mehr Methoden, wie beispielsweise eine Hardware-Implementierung des Pulse-Counters.
  • Auch das WLAN kann einiges mehr. Unter anderem 802.11v BSS Transition Management & 802.11k Radio Resource Management. Klingt vielleicht komisch, heißt aber nur, dass du mit dem ESP32 weniger Probleme haben kannst, eine Verbindung zum WLAN herzustellen.
  • Es gibt inzwischen viele Varianten, etwa ESP32-C3, ESP32-S3 oder ESP32-C6. Beim Kauf lohnt sich ein Blick, welche Variante verbaut ist, denn in ESPHome gibst du genau diese an.
• Der ESP8266 hat nur 1nen CPU-Kern und unterstützt weniger Hardware-Methoden. (Er kann aber trotzdem genau so einen Pulse-Counter definieren, nur eben über die Software)

ESPHome selbst bezeichnet den ESP32 inzwischen als den modernen Standard für DIY-Geräte. Wenn du neu kaufst, ist er deshalb meist die bessere Wahl.

Board

Des Weiteren gibt es das Board, welches den Formfaktor des gekauften Artikels, teilweise das Pinout und ob es Breadboard-Kompatibel ist, bestimmt. Beispielsweise hier die Beschreibung von D1 Mini Board.

Das D1 Mini ist ein Breadboard-kompatibles WiFi-Entwicklungsboard auf Basis des ESP8266.
Dieses Board ist kompatibel mit der Arduino IDE und mit NodeMCU.
Alle I/O-Pins haben Interrupt-, PWM-, I2C- und One-Wire-Fähigkeit, mit Ausnahme von Pin D0.

https://www.addicore.com/D1-Mini-Dev-Board-p/ad318.htm

Noch ein Hinweis an der Stelle: Obwohl beispielsweise das D1 Mini Board Design auf dem ESP8266 basiert, gibt es trotzdem welche mit ESP32 Chip*.

NodeMCU

NodeMCU ist eine Open-Source-Firmware, für die Open-Source-Prototyping-Board-Designs verfügbar sind. Der Name „NodeMCU“ setzt sich aus „Node“ (Knoten) und „MCU“ (Micro-Controller Unit) zusammen. Genau genommen bezieht sich der Begriff „NodeMCU“ auf die Firmware und nicht auf die zugehörigen Entwicklungskits.

Es ist also einfach gesagt das Zusammenspiel aus Hardware und Firmware mit den ESP-Mikrocontrollern und einem vollen TCP/IP Stack (Netzwerkfähigkeit). Wenn du ESPHome aufspielst, ersetzt es diese Firmware übrigens komplett, der Name auf dem Board ist dann nur noch eine Bezeichnung für das Board-Design.

ESP32 & ESP8266 Hardware

Bevor du jetzt auf Amazon gehst, nach ESP32 suchst und absteigend nach Preis sortierst sei gewarnt, dass die (zu)billigen häufig schlecht verlötet sind, der WLAN-Empfang katastrophal & kaputte Boards normal sind.

Einen guten Hersteller zu finden, dem man selber vertraut und dabei zu bleiben, ist wirklich eine gute Idee.

ESP32 Entwicklerboard

ESP32 Pinout Reference

Alternative 1: ESP32 auf D1 Mini Board*.

ESP8266 Entwicklerboard

ESP8266 Pinout Reference

• Alternative 1: ESP8266 D1 Mini V3* (Im Video gezeigt, Boards haben häufig Verbindungsprobleme)
• Alternative 2: ESP8266 D1 Mini Pro* (Externer Antennenanschluss nach Umlöten des Widerstands, mehr Speicher, leichter, OnBoard-Keramikantenne für WLAN)

Sensoren / Aktoren / Spezielle Module

In diesem Kit ist ebenfalls die Ampel und das Mikrofonmodul für das Projekt mit enthalten:

Alle nativ unterstützten Komponenten findet man direkt in der esphome Doku-Seite.

Sensoren

Mikrofon

Wurde auch im Beispielprojekt genutzt (Aus dem Set von oben).

Linienfolger

Im Projekt zu Ferraris-Stromzähler digitalisieren benutzt.

Bewegungsmelder (PIR)

Zur Bewegungserkennung sehr praktisch.

Temperatur / Luftdruck / Luftfeuchtigkeit usw.

• Der BME280* misst Temperatur, Luftdruck und Luftfeuchtigkeit in einem Sensor und löst sehr fein auf (0,01 Grad), ist aber auch kostspielig
• Bitte kaufe dir keine DHT11* (Temperatur, extrem ungenau)
• Der DHT22* (Temperatur & Luftfeuchtigkeit) eher auch nicht, wenn du keine Abweichung um im Extremfall bis zu einem halben Grad in Kauf nehmen willst
• Der AHT10* (Temperatur & Luftfeuchtigkeit) ist mit +- 0,3 Grad schon etwas genauer
• Ich halte den HDC1080 für Preiswert & genau, mit +- 0,2 Grad

Wie genau fertige Luftsensoren im Vergleich messen, habe ich übrigens in einem eigenen Beitrag getestet: Smart Home Luftsensoren: Welche sind wirklich genau?

Aktoren

RGB-Ampel

Wurde auch im Beispielprojekt genutzt (Aus dem Set von oben).

Relais

Relais sind einfache elektronische Bauteile, mit denen du eine hohe Last mit nur einem einzigen Pin auf deiner Platine schalten kannst.

Alternativ gibt es auch schon komplette „Module“* oder Boards mit vier Relais*, zum Flashen wird dann aber ein USB-Adapter* benötigt.

MCP2515 CAN Bus Shield

Hierüber kann mit einem CAN-Bus kommuniziert werden. Für sehr spezielle Einsatzzwecke geeignet, wie ggf. das Einbinden von Wärmepumpen in Home Assistant oder sonstiger Gebäudetechnik mit CAN-Bus.

ESP32 Cam

Kann unter anderem für AI-on-the-edge-device genutzt werden (Digitalisieren analoger Zähler / Anzeigen und Instrumente). Das ist eine eigene Firmware und nicht ESPHome, wie das genau geht, zeige ich in diesem Beitrag: Analoge Zähler mit AI-on-the-edge & Home Assistant digitalisieren

(Alternative, AZ-Delivery Modell* aktuell nicht lieferbar)

Zum Flashen des ESP32 auf dem ESP32 Cam Modul wird in jedem Fall ein FT232RL USB zu TTL Serial Adapter* benötigt. Nicht vergessen, den Jumper auf 5V zu stellen 😉

Zubehör

ESPHome in Home Assistant einrichten

Jetzt wird es praktisch: So bekommst du ESPHome in Home Assistant, flashst dein erstes Board und bindest es ein. Das Werkzeug dafür heißt ESPHome Device Builder. Seit ESPHome 2026.6 ist das die neue Oberfläche, die das alte ESPHome-Dashboard ablöst, deshalb sieht es bei dir anders aus als im Video.

1. ESPHome Device Builder als App installieren

Add-ons heißen in Home Assistant seit Version 2026.2 Apps. Die ESPHome-App installierst du so:

1. Öffne Einstellungen → Apps und klicke auf App installieren.
2. Suche nach ESPHome Device Builder und öffne den Eintrag. Alternativ springst du direkt über diesen My-Home-Assistant-Link zur App.
3. Klicke auf Installieren, danach auf Starten. Wenn du magst, aktivierst du noch die Anzeige in der Seitenleiste, dann hast du ESPHome immer einen Klick entfernt.
4. Öffne die Oberfläche der App. Beim allerersten Start fragt dich der Device Builder nach deinen WLAN-Zugangsdaten, damit neue Geräte direkt in dein Netz kommen.

Taucht die App nicht in der Liste auf, fehlt das ESPHome-Repository. Das fügst du über das Drei-Punkte-Menü oben rechts unter Repositories mit https://github.com/esphome/home-assistant-addon hinzu.

Läuft dein Home Assistant ohne Apps (zum Beispiel als Docker-Container), kannst du ESPHome separat betreiben, etwa mit der ESPHome-Desktop-App oder als eigenen Container. Die Schritte ab hier sind dann die gleichen.

2. Erstes Gerät anlegen

1. Klicke im Device Builder auf Create device und wähle New Device Setup. Das ist der geführte Assistent, den ESPHome selbst für den Einstieg empfiehlt.
2. Gib deinem Gerät einen Namen (zum Beispiel esphome-test) und wähle dein Board bzw. die Chip-Variante aus, also etwa einen ESP32 oder einen ESP8266 D1 Mini. Der Device Builder zeigt dir dabei auch, welche Pins dein Board hat.
3. Achte darauf, dass die WLAN-Daten in der Konfiguration stehen. Ohne sie findet das Gerät nach dem Flashen nicht in dein Netz.

Der Assistent erzeugt dir eine fertige Grundkonfiguration inklusive Verschlüsselungsschlüssel. Sensoren und Schalter fügst du anschließend entweder über den Komponenten-Katalog per Klick hinzu oder klassisch im YAML-Editor, wie im Beispiel weiter unten.

3. Das erste Mal per USB flashen

Die allererste Installation muss per USB-Kabel passieren, erst danach geht alles per WLAN. Wichtig: Nimm ein Datenkabel, ein reines Ladekabel funktioniert nicht.

1. Schließe das Board per USB an deinen Computer an (nicht an den Home-Assistant-Server).
2. Klicke auf der Gerätekarte auf Install. ESPHome baut jetzt die Firmware, das dauert beim ersten Mal ein paar Minuten.
3. Wähle die Installation über den Browser per USB. Dafür brauchst du einen Desktop-Browser mit WebSerial-Unterstützung, zum Beispiel Chrome oder Edge.

Ein paar Stolpersteine, die beim ersten Flashen typisch sind:

• Kein HTTPS: Der Browser gibt den USB-Port nur auf sicheren Seiten frei. Rufst du Home Assistant per http:// auf, übergibt der Device Builder die Firmware an ESPHome Web (web.esphome.io) und das Flashen läuft dort. Alternativ lädst du die Firmware als Datei herunter und spielst sie dort selbst auf.
• Board wird nicht erkannt: Viele günstige Boards brauchen einen Treiber für ihren USB-Chip, meist CH340 oder CP2102. Welcher Chip verbaut ist, steht oft schon im Produktnamen.
• Verbindung klappt trotzdem nicht: Halte beim Einstecken den BOOT-Knopf gedrückt (der zieht GPIO0 auf Masse) und lass ihn nach ein paar Sekunden los. Damit startet der ESP im Flash-Modus.
• Board ohne USB-Buchse: Bei der ESP32 Cam oder ESP-01S brauchst du den USB-Adapter aus der Hardware-Liste oben.

4. Gerät in Home Assistant hinzufügen

Sobald das Board mit deinem WLAN verbunden ist, findet Home Assistant es in der Regel von selbst. Unter Einstellungen → Geräte & Dienste erscheint es als entdecktes Gerät, das du mit einem Klick hinzufügst. Fragt Home Assistant nach einem Verschlüsselungsschlüssel, findest du ihn in der YAML-Konfiguration deines Geräts unter api: encryption: key.

Wird das Gerät nicht entdeckt (zum Beispiel weil mDNS in deinem Netz blockiert ist), klickst du unter Einstellungen → Geräte & Dienste auf Integration hinzufügen, suchst nach ESPHome und gibst den Hostnamen (z. B. esphome-test.local) oder die IP-Adresse ein.

Gut zu wissen: Standardmäßig darf ein ESPHome-Gerät selbst keine Aktionen in Home Assistant auslösen. Diese Option schaltest du in den Einstellungen der ESPHome-Integration pro Gerät frei, aber nur für Geräte, denen du vertraust.

5. Änderungen per WLAN aufspielen

Ab jetzt brauchst du kein Kabel mehr. Änderst du die Konfiguration, speicherst du sie und klickst wieder auf Install, diesmal mit der Installation per WLAN. Nur Speichern reicht nicht, erst mit Install wird die neue Firmware gebaut und auf das Gerät gespielt.

Abkürzung: fertige Projekte direkt aus dem Browser

Willst du erst mal nur ausprobieren, schau dir die Ready-Made Projects von ESPHome an. Darüber spielst du zum Beispiel einen Bluetooth-Proxy für Home Assistant mit ein paar Klicks direkt aus dem Browser auf einen ESP32, ganz ohne eigene Konfiguration. Fertige Konfigurationen für viele Geräte findest du außerdem in der ESPHome-Gerätedatenbank.

Code für das ESP32-Projekt aus dem Video

Im Video steuere ich eine kleine Ampel über drei Schalter und werte ein Mikrofonmodul als Geräuschsensor aus. Der obere Teil der Konfiguration (Name, Board, API, OTA, WLAN) entsteht im Assistenten automatisch, den behältst du am besten so, wie er bei dir erzeugt wurde, inklusive deiner eigenen Schlüssel. Neu dazu kommen nur die markierten Zeilen ab switch:.

esphome:
  name: esphome-test

esp32:
  variant: esp32
  framework:
    # Seit ESPHome 2026.1 Standard, Arduino nur bei Bedarf explizit setzen
    type: esp-idf

# Logs aktivieren
logger:

# Native API für Home Assistant
api:
  encryption:
    # Deinen eigenen Schlüssel erzeugt der Assistent
    key: "DEIN_API_SCHLUESSEL"

# Updates per WLAN, verschlüsselt mit dem API-Schlüssel (ab ESPHome 2026.9)
ota:
  - platform: esphome
    encryption:

wifi:
  ssid: !secret wifi_ssid
  password: !secret wifi_password

  # Fallback-Hotspot, falls das WLAN nicht erreichbar ist
  ap:
    ssid: "Esphome-Test Fallback Hotspot"
    password: "DEIN_HOTSPOT_PASSWORT"

captive_portal:

# Ab hier: die Ampel und das Mikrofon aus dem Video

switch:
  - platform: gpio
    name: green_light
    pin: GPIO15
  - platform: gpio
    name: yellow_light
    pin: GPIO0
  - platform: gpio
    name: red_light
    pin: GPIO16

binary_sensor:
  - platform: gpio
    pin: GPIO26
    name: "Sound level"
    filters:
      - delayed_off: 1s

Was sich gegenüber dem Video geändert hat:

• OTA braucht eine Plattform: Seit ESPHome 2024.6 steht unter ota: immer - platform: esphome, ohne diese Zeile lässt sich die Konfiguration nicht mehr validieren. Ab ESPHome 2026.9 empfiehlt ESPHome außerdem encryption: statt eines OTA-Passworts, dann nutzt das Update denselben Schlüssel wie die API.
• ESP-IDF statt Arduino: Seit ESPHome 2026.1 ist ESP-IDF das Standard-Framework für ESP32, ESP32-C3, ESP32-S2 und ESP32-S3. Arduino geht weiterhin, du musst es dann aber ausdrücklich mit type: arduino setzen. Das brauchst du nur für Komponenten, die ESP-IDF nicht unterstützen.
• variant statt board: ESPHome empfiehlt inzwischen, beim ESP32 nur noch die Chip-Variante anzugeben. Ein älteres board: esp32dev funktioniert weiterhin.

Noch ein Hinweis zu den Pins: GPIO0 und GPIO15 sind sogenannte Strapping-Pins, die beim Start des ESP32 den Boot-Modus mitbestimmen. ESPHome zeigt dafür beim Prüfen eine Warnung an. Als Ausgang wie hier für die Ampel klappt das, für Taster oder Sensoren nimmst du bei eigenen Projekten aber besser einen anderen Pin.

Was du mit ESPHome und ESP32 bauen kannst

Wenn das erste Gerät läuft, geht es meist schnell weiter. Ein paar Projekte, die ich schon umgesetzt habe:

• Ferraris-Stromzähler mit ESPHome auslesen (mit dem Linienfolger von oben)
• Bewässerungscomputer selber bauen mit ESPHome & Home Assistant
• Analoge Zähler mit der ESP32 Cam und AI-on-the-edge digitalisieren (eigene Firmware, nicht ESPHome)
• WLED Tutorial: Smarte LED-Beleuchtung günstig selbst bauen (ebenfalls mit ESP32, aber mit der eigenen Firmware WLED)

Fazit

Ich hoffe ich konnte dir helfen, mit ESP32 sowie ESP8266 Mikrocontrollern etwas warmzuwerden und zu verstehen, wie ESPHome uns als Home Assistant Nutzer helfen kann, eine Firmware mit verständlicher YAML-Syntax über WiFi darauf zu flashen 🙌 Mit dem Device Builder ist der Einstieg heute sogar noch etwas einfacher als im Video.

Wenn du Fragen oder Anmerkungen hast, zögere nicht, sie mir unten in den Kommentaren mitzuteilen und ich werde mein Bestes tun, um dir zu helfen. Vielen Dank fürs Lesen!