Troubleshooting

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.

Common problems

ProblemWhat to do
The camera won't read the QRWipe 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 fastThe device isn't in setup mode. Hold RESET for 5 seconds. See Status light & reset.
My phone won't join SME-SetupMove 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 internetTap 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 listThe 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 slowlyThe 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 OfflineCheck 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

Was this page helpful?