Guides ยท 02
Connect Your Lights
Pairing the app with a real WLED controller โ and the one browser rule that trips people up.
๐ก Adding a controller
- Open the WLED screen in the app.
- Enter the controller's IP address (find it on your router's device list, or via the WLED AP setup if it hasn't joined Wi-Fi yet).
- The app probes
/json/infoโ a green status chip means it's connected and readable.
Important
WLED controllers serve plain http://, not https. Browsers block a secure (https://) page from talking to an insecure local device โ this is a browser security rule called mixed content, and there's no setting to override it.
That means:
- โ
The app connects fine when it's opened via http:// โ e.g. hosted right on the controller, or run from your own computer with
npx serve .and opened athttp://localhost:3000. - โ It cannot connect to a real controller when loaded from an https:// site โ including the live preview on this marketing site. That preview is for exploring the UI only.
๐ข Getting the real, connectable app
The connectable app is provided directly to licensed installers as part of onboarding โ not as a public download from this site. Once you're set up, it runs the same three ways:
- Opened directly from a WLED controller's file system (fastest for on-site installs), or
- Run locally on a laptop/phone (
npx serve .โhttp://localhost:3000), or - Added to a phone's home screen as a PWA once served over http.
Not licensed yet? Request licensing info.
๐ Multiple controllers
Add as many controllers as you have โ Luma probes all saved ones at once on launch and reconnects automatically even if an IP changes, by matching each controller's MAC address.