WLED auf einem ESP32 installieren und mit Home Assistant verbinden¶

Veröffentlicht am 12. August 2026 · Geschätzte Lesezeit: 5 Minuten

WLED macht aus einem ESP32 einen lokalen Controller für adressierbare LED-Streifen. Farben, Helligkeit und Effekte laufen direkt auf dem Mikrocontroller und lassen sich anschließend über Home Assistant steuern. Flashen, Grundeinstellung und Integration dauern ungefähr 25 Minuten.

Voraussetzungen

Ein unterstützter ESP32 oder fertiger WLED-Controller
Ein kompatibler adressierbarer LED-Streifen
Ein zum Streifen passendes, ausreichend dimensioniertes Netzteil
Ein USB-Datenkabel und ein Chromium-basierter Browser

1. Spannung und Verdrahtung prüfen¶

Prüfe vor dem Anschließen die Betriebsspannung des LED-Streifens. Netzteil, Controller und Streifen müssen elektrisch zusammenpassen. Der ESP32-Datenpin wird mit DIN des Streifens verbunden; Controller und LED-Netzteil benötigen eine gemeinsame Masse.

Brand- und Geräteschaden vermeiden

Schließe niemals einen 5-Volt-Streifen an 12 oder 24 Volt an. Dimensioniere Netzteil, Sicherung, Leitungsquerschnitt und Einspeisepunkte passend zur maximalen Last. Der WLED-Helligkeitsbegrenzer ersetzt keine sichere Elektroplanung. Trenne die Versorgung vor jeder Änderung.

Für einen ersten Funktionstest verwendest du wenige LEDs und eine begrenzte Helligkeit. Baue längere Streifen erst nach erfolgreichem Test fest ein.

2. WLED über den Web-Installer flashen¶

Verbinde den ESP32 nur per USB-Datenkabel mit dem Rechner. Öffne den offiziellen Installer in Chrome, Edge oder einem anderen Browser mit Web-Serial-Unterstützung:

https://install.wled.me/

Klicke auf Install, wähle den richtigen seriellen Anschluss und bestätige das Löschen des bisherigen Flash-Inhalts nur, wenn auf dem ESP32 keine benötigte Konfiguration mehr liegt. Warte, bis die Installation vollständig abgeschlossen ist, und ziehe das USB-Kabel währenddessen nicht ab.

Richtigen Anschluss auswählen

Trenne bei Unsicherheit andere USB-Seriell-Geräte vorübergehend. Das Flashen löscht die bisherige Firmware des ausgewählten Mikrocontrollers.

3. WLAN einrichten¶

Nutze nach dem Flashen die vom Installer angebotene WLAN-Einrichtung. Falls sie nicht erscheint, verbinde dich mit dem temporären WLED-Zugangspunkt und öffne die angezeigte Einrichtungsseite. Trage SSID und Passwort deines 2,4-GHz-WLANs ein und wähle einen eindeutigen Gerätenamen, zum Beispiel wled-wohnzimmer.

Nach Save & Connect wechselt der ESP32 ins Heimnetz. Reserviere seine IP-Adresse im Router dauerhaft. Die lokale Oberfläche erreichst du anschließend über:

http://<wled-ip>

Ersetze <wled-ip> durch die private Adresse aus dem Router. Leite diese Adresse nicht über eine Router-Portfreigabe ins Internet weiter.

4. LED-Ausgang konfigurieren¶

Öffne in WLED Config → LED Preferences. Trage den tatsächlichen LED-Typ, den am Controller verwendeten GPIO-Datenpin, die Anzahl der LEDs und die richtige Farbreihenfolge ein. Diese Werte stammen aus den Unterlagen deines Controllers und LED-Streifens.

Aktiviere den automatischen Helligkeitsbegrenzer und setze den maximalen Strom nicht höher als Netzteil, Sicherung und Verkabelung sicher liefern können. Speichere die Einstellungen und teste nacheinander Rot, Grün, Blau und Weiß.

Falsche Farben sind meist eine Einstellung

Leuchtet Rot beispielsweise grün, ändere zuerst die Farbreihenfolge in den LED-Einstellungen. Tausche nicht wahllos Leitungen und erhöhe bei flackernden LEDs nicht einfach das Stromlimit.

5. Preset für den Alltag speichern¶

Stelle eine moderate Helligkeit, Farbe und einen Effekt ein. Öffne den Preset-Bereich, speichere den aktuellen Zustand unter einem eindeutigen Namen wie Abendlicht und merke dir die Preset-Nummer.

Mit ruhigem Preset beginnen

Ein statisches oder langsam animiertes Preset eignet sich besser für Automationen als ein sehr heller schneller Effekt. So lässt sich die Stromversorgung zunächst zuverlässig beurteilen.

6. WLED in Home Assistant hinzufügen¶

Öffne in Home Assistant Einstellungen → Geräte & Dienste. WLED wird im gleichen Netz häufig automatisch entdeckt. Wähle Konfigurieren und ordne das Gerät einem Bereich zu.

Falls keine Entdeckung erscheint, klicke auf Integration hinzufügen, suche nach WLED und trage die private Adresse ein:

<wled-ip>

Home Assistant erstellt unter anderem eine Licht-Entität sowie auswählbare Effekte und Presets. MQTT ist für die native WLED-Integration nicht erforderlich.

7. Steuerung und Automation testen¶

Füge die neue Licht-Entität einem Dashboard hinzu. Teste Ein/Aus, Helligkeit, Farbe und das gespeicherte Preset. Erstelle danach bei Bedarf eine einfache Automation, die Abendlicht zu einer bestimmten Zeit oder bei erkannter Anwesenheit aktiviert.

Keine sicherheitskritische Beleuchtung ersetzen

WLED, WLAN und Home Assistant können ausfallen. Verwende die Installation nicht als alleinige Fluchtweg-, Treppen- oder Sicherheitsbeleuchtung.

8. Backup und Rückweg¶

Öffne die WLED-Einstellungen und sichere Konfiguration sowie Presets über die angebotenen Backup-Funktionen. Für ein manuelles Preset-Backup kannst du bei deaktivierter OTA-Sperre diese lokale Adresse öffnen:

http://<wled-ip>/edit

Lade dort mindestens presets.json herunter. Bewahre die Dateien zusammen mit Notizen zu LED-Typ, GPIO, Anzahl, Farbreihenfolge und Stromlimit auf.

Für den Rückweg trennst du zuerst das LED-Netzteil. Du kannst denselben stabilen WLED-Stand erneut über den offiziellen Installer flashen und danach die gesicherten Dateien wiederherstellen. Entferne die WLED-Integration in Home Assistant erst, wenn das Gerät nicht mehr verwendet wird.

9. Typische Fehler beheben¶

ESP32 erscheint nicht im Installer: USB-Datenkabel, Browserfreigabe und benötigten USB-Seriell-Treiber prüfen; manche Kabel können nur laden.
WLED verbindet sich nicht: 2,4-GHz-WLAN, SSID und Kennwort prüfen und das Gerät näher an den Zugangspunkt bringen.
LEDs bleiben dunkel: Spannung, gemeinsame Masse, Datenrichtung DIN, GPIO und LED-Anzahl kontrollieren.
Falsche Farben: Farbreihenfolge in LED Preferences ändern.
Flackern oder Neustarts: Netzteil, Leitungsquerschnitt, Einspeisung und Stromlimit prüfen; Helligkeit für den Test deutlich reduzieren.
Home Assistant findet WLED nicht: Gerät manuell mit der festen privaten IP hinzufügen und mDNS- beziehungsweise VLAN-Regeln kontrollieren.

10. Quellen und Video¶

Fertig¶

WLED steuert den LED-Streifen nun lokal und ist als Licht in Home Assistant verfügbar. Schalte zur Funktionsprüfung das Licht im WLED-Browser ein, ändere es danach in Home Assistant und prüfe, ob Helligkeit, Farbe und Preset in beiden Oberflächen denselben Zustand zeigen.