WLED gives you full control over addressable LED strips with smooth animations, custom colours, and instant responsiveness — all running locally on an ESP32. Pairing it with the WLED WiFi Remote gives you physical control from anywhere in your home without needing the app.

This guide walks you through setting up the DOMRAEM ESP32 LED controller, connecting it to WLED, pairing the remote, and getting everything running smoothly. Not only this but you can even add it to your Home Assistant setup allowing clean and easy automations. 

What You’ll Need

• DOMRAEM WLED LED Strip Controller ESP32

• DOMRAEM WLED WiFi Remote (optional)

• 5V or 12V addressable LED strip (WS2812B, SK6812, etc.)

• Appropriate power supply (5V or 12V depending on strip)

• Phone or laptop on 2.4GHz Wi-Fi

• Home Assistant (optional)

Step 1 — Wire the LED Strip to the ESP32 Controller

1. Connect LED +5V (or +12V) to the controller’s V+ terminal. 

2. Connect LED GND to the controller’s G terminal.

3. Connect LED Data In to the D output terminal on the controller.
   

4. Power on the ESP32 controller using any of the appropriate methods. 

Tip: Make sure the LED data wire goes to DIN, not DOUT — reversed strips won’t light.

The ESP32 will now start broadcasting a Wi-Fi network named:

WLED-XXXXXX

Step 2 — Connect to WLED and Configure Wi-Fi

1. On your phone/laptop, open Wi-Fi and join the network WLED-AP. If there is no AP network, hold the Opt button for 10 seconds to enter AP mode. 

2. A captive portal will open automatically. If not, visit: http://4.3.2.1

3. Enter your Wi-Fi SSID and password then save.

4. The controller will reboot and join your network.

To find it again:

• Check your router’s connected devices list, OR

• Use wled.local in your browser or use the WLED app, OR

• Check Home Assistant (it auto-discovers WLED) and click visit device

Step 3 — Pair the WLED WiFi Remote

The WLED WiFi remote works by sending HTTP/MQTT commands to the local WLED controller.

Pairing the Remote

1. In the WLED menu, move to Config -> WiFi Setup
2. Enable ESP-NOW Wireless, then click "Save & Connect.
3. Long press any button on the WLED remote control for at least 5 seconds, and then go back to "WiFi Setup"
4. At the bottom of the page copy the string after last device seen and put it in "Paired Remote MAC", then press "Save & Connect". If there is no string, just refresh the page.
5. After it resets the remote should now function properly. 

Your remote should now be able to:

• Turn the LEDs on/off

• Change brightness

• Set colours

• Switch presets

• Trigger effects wirelessly

All locally — no cloud involved.

Step 4 — Optional: Add WLED to Home Assistant

Home Assistant automatically discovers WLED.

1. Go to Settings → Devices & Services

2. Find the card that says WLED, it should have autodiscovered.  

3. Click Add, follow the steps to finish setup. 
   

4. You will now be able to control all the feautres of the LED via Home Assistant. 

You now have:

• On/Off control

• Brightness

• Effect selection
  

• Trigger-based scenes (motion → LED on, etc.)

FAQ

Can WLED and the remote work without internet?

Yes — everything works locally, including the remote.

What LED strips does this support?

Any addressable strip such as WS2812B, SK6812, WS2815, APA102, and more.

Do I need a level shifter?

Most 5V strips work directly with ESP32 data output, but long cable runs may need a level shifter.

Can I control multiple strips?

Yes — if the controller supports multiple outputs, WLED can drive each one.

WLED isn't appearing in Home Assistant?

Make sure WLED is connected to Wifi correctly, restart HA aswell. To check the device is online you visit http://wled.local. 

Device doesn't show WLED Wi-Fi network?

• Press the reset button on the ESP32

• Hold the button for 5s to force AP mode

• Power-cycle the controller