wled.deby LED-Emotion DE

Guide

Install WLED

Flash the ESP32 in the browser via USB in a few minutes. Usually not needed for ready-made WLED controllers.

Short answer
WLED is flashed to the ESP32 with the official web installer install.wled.me in Chrome or Edge over a USB data cable. Controllers shipped with WLED don’t need flashing: power on and set up right away.
Step 1

Check whether flashing is needed

The GLEDOPTO WLED controllers in the range ship with WLED. You only need to flash for your own ESP32 board, a fresh start, or after a failed update. The 4321-WL4 (MiBoxer) runs vendor firmware with RF and Tuya features: please ask us before reflashing it.

Step 2

USB data cable and browser

A USB cable that carries data (charge-only cables won’t work) and Chrome or Edge on a computer. Firefox and Safari don’t support the required Web Serial interface.

Step 3

Open the web installer

Open install.wled.me, pick the current stable release and, for controllers with an Ethernet port, the Ethernet variant. Click “Install” and select the controller’s serial port.

Step 4

No port shown?

Install the driver for the USB-serial chip (often CH340 or CP2102, see datasheet). Some boards need the BOOT button held while plugging in. Try another cable and USB port.

Step 5

Erase or keep

“Erase device” resets all settings, useful when troubleshooting. A plain update without erasing usually keeps settings. Back up first under Config → Security & Updates.

Step 6

Set up Wi-Fi

After flashing, the installer offers to enter Wi-Fi directly. Alternatively connect to the WLED-AP hotspot (password wled1234) and set up at 4.3.2.1. WLED only uses 2.4 GHz Wi-Fi.

Later updates

If WLED is already running, updates work without a cable: download the matching .bin from the releases page and upload it under Config → Security & Updates → Manual OTA. The file must match the chip (ESP32, ESP32-C3, ESP32-S3 …).

Safety
Disconnect the PSU from mains before working on cables. Work on the 230 V side only by a qualified electrician.

Sources: install.wled.me · WLED docs: Getting started · WLED releases

Related

Set up WLED →

From unboxed controller to the first effect: the five settings that matter.

Update failed or controller won’t start →

Troubleshooting: 4 checks

Controller can't be reached on the network →

Troubleshooting: 4 checks

For business
Questions about your setup? LED-Emotion advice: +49 5132 8305530, Mon–Fri 9 am–4 pm CET, or request support.