Docs / QR onboarding / Troubleshooting
QR onboarding
Troubleshooting
Most setup problems come down to the Wi-Fi, a permission on the phone, or a device that still belongs to someone else. Find the message the app showed, or the problem you see.
Messages from the appCommon problemsReset as a last step
For people who bought a ready-made deviceThese pages are for customers setting up a product that came with a QR sticker. Building your own board? Use Quick start in Developer Mode instead.
What the app says
Type a few words from the message, or pick a topic.
No message matches. Try fewer words, or see the common problems below.
Common problems
| Problem | What to do |
|---|---|
| The camera won't read the QR | Wipe the sticker, add light or tap the flashlight icon, and hold the phone 15–20 cm away. Still no luck? Type the claim code printed on the sticker or box. |
| The light isn't blinking fast | The device isn't in setup mode. Hold RESET for 5 seconds. See Status light & reset. |
| My phone won't join SME-Setup | Move next to the device. Turn off any VPN. On iPhone, tap Join when asked; on Android, tap Connect. |
| Android asks to keep a network without internet | Tap Yes or Keep. The device hotspot has no internet on purpose, and it is only used for a moment. |
| My Wi-Fi isn't in the list | The device only sees 2.4 GHz networks. Move it closer to the router, or turn on the 2.4 GHz band in the router settings. |
| Light keeps blinking slowly | The device can't reach your Wi-Fi or the internet. Check the router is online, then reset and add it again. |
| It was working, now it shows Offline | Check the device has power and your internet works. If you changed your Wi-Fi password, reset and add it again. |
Still stuck?Reset the device and start again from Add a device. If it still doesn't work, talk to us and tell us the message you see.
Next steps
SetupAdd a deviceScan the QR sticker and connect.DeviceStatus light & resetWhat the light means, and how to start over.
Was this page helpful?
Docs