Skip to main content
Onboarding links a physical device to a user’s account. In the official Hyperwisor app it is one continuous flow: scan the QR and the app takes it from there, full-screen, step by step, until the device reports online.

Prerequisites

  • The official Hyperwisor app installed and signed in
  • The device powered on, with its QR code affixed
  • Your Wi-Fi name and password (2.4 GHz — see the note at the end)

The flow

1

Scan the QR code

The app reads the product from the QR and opens Finding your device full-screen. The device is added to your account automatically — there is no separate confirm step.
2

Name the device

Give it an identifier so you can tell it apart from others of the same product. You can skip this and rename it later.
3

Enter your Wi-Fi

The network name and password you want the device to join.
4

Connect your phone to the device's setup network

The app asks you to do this and waits for you to confirm — it cannot hand the credentials over any other way.The name ends in the last six characters of the device id, so several devices in setup mode are still distinguishable.
Leaving your home Wi-Fi is expected. Your phone has to be on the device’s network for this one step, because the device is not on the internet yet.
5

Credentials handed over, then rejoin the internet

The app sends your Wi-Fi to the device, and the device returns its public key. Then your phone leaves the setup network and rejoins the internet.
6

Security key registered

Now that the phone is back online, the app registers the device’s public key against your account. This step is why the device will be trusted when it connects — without it the platform has no way to tell your device from anyone else’s.
7

Waiting for the device to come online

The device restarts, joins your Wi-Fi and authenticates. The app keeps checking. This usually takes a few seconds, occasionally longer on a slow network — after a minute you can close the screen and let it finish in the background.

If it does not come online

A wrong Wi-Fi password looks the same as a device that is still trying. The device does not report back that the credentials failed — it simply keeps retrying, and nothing appears in the app. There is no error message to wait for.
Also worth knowing: a device that has already been given credentials will not raise its setup network again on its own. So if the password was wrong, you cannot just power-cycle it and rescan. What to do:
  1. Check the network is 2.4 GHz and the password is right.
  2. Put the device back into setup mode the way its manufacturer documents — usually a reset button or a mode switch, not a power cycle.
  3. Run through the flow again.
Use a 2.4 GHz network. The device’s radio is 2.4 GHz only. A 5 GHz-only network, or 5 GHz credentials, will not connect — this is the most common cause of a setup that never completes.

Using your device

Once online, monitor and control it from the dashboard.