Troubleshooting
Controller keeps rebooting
3 checks, sorted by how often they are the cause. For all WLED controllers with ESP32.
Check in this order: the most common and simplest cause comes first. Usually the cause is found after two or three steps.
Most common cause
Voltage dips? On bright effects an undersized PSU sags and the ESP32 reboots. Set the current limiter or use a bigger PSU.
Voltage dips?
On bright effects an undersized PSU sags and the ESP32 reboots. Set the current limiter or use a bigger PSU.
Too many LEDs or effects?
Check LED Memory Usage in LED Preferences. Many segments, 2D effects and real-time at once strain memory.
After an update?
WLED 16 detects boot loops and recovers by itself. Otherwise re-flash via USB with install.wled.me and restore your backup.
Safety
Disconnect the PSU from mains before working on cables. Work on the 230 V side only by a qualified electrician.
Further help
Set planner →
Calculate PSU, feed points, current per pixel and matching controllers for your strip.
LED-Emotion: WLED basics (German) ↗
Power supply, consumption, GND, level shifter and installation explained in detail.
For business
Not solved? LED-Emotion’s WLED support (typically 30 minutes via remote or phone) usually finds the cause right away: request support · +49 5132 8305530.
Other problems
- Nothing lights up at all
- Flickering, glitter or random colours
- Colours are wrong (red is green …)
- Reddish, yellowish or dimmer towards the end
- Controller can't be reached on the network
- Too dim even at full brightness
- Glows or flashes when switched off
- Doesn't react to music
- Remote doesn't respond
- Lights up only up to a certain point
- Second output or zone stays dark
- Effects stutter or run slowly
- Strip, PSU or controller gets hot
- White looks bluish, pink or uneven
- Settings or presets are gone
- Update failed or controller won’t start
- Home Assistant can’t find WLED
- Schedule switches at the wrong time
- Several controllers aren’t in sync