Claim and onboard issues
Problems claiming a gateway after browser flash or SoftAP setup.
Claim returns “Invalid device credentials”
Usually the gateway has not registered with the cloud yet (Wi‑Fi just joined).
- Keep the gateway powered and on the target Wi‑Fi.
- Retry claim — the onboard form polls for about 90 seconds.
- If it still fails, open a serial monitor at 115200 and confirm the gateway ID / claim code match the form.
- Confirm production firmware is
0.1.4or newer (claim-code path).
Wrong claim code or typo also returns the same generic 401 — double-check the code from the label or serial log.
Claim blocked: verify your email
If production has email verification enabled, claim returns 403 until the address is verified.
- Open the verification link from the registration email.
- Sign in again (prefer the same browser that started onboard).
- Return to
/onboard?device=…&code=…or Gateways → Claim.
Gateway already claimed (409)
The gateway is bound to another account. Use factory reset on the gateway (long BOOT hold) only if you own the hardware, then claim again from the intended account.
Onboard deep link lost after login/register
The flasher sends you to /onboard?device=…&code=…. Auth should preserve that via ?next= and session storage.
If the link is lost:
- Re-open the URL from the flasher success screen, or
- Enter gateway ID + claim code manually at app.jkbmsr.com/devices/claim.
SoftAP works but claim fails
Captive portal only configures Wi‑Fi. The gateway must still reach api.jkbmsr.com on the customer network (outbound HTTPS). Captive portals that block unknown hosts will prevent register/claim.