> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperwisor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding Overview

> The ways a user adds a device to their account — and the official-app QR + Wi-Fi flow.

Onboarding links a physical device to a user's account so they can monitor and
control it. There are a few paths depending on which app the user has.

## The methods

<CardGroup cols={2}>
  <Card title="Official Hyperwisor app" icon="mobile" href="/onboarding/official-app">
    Scan the device's QR code, then send Wi-Fi credentials in AP mode. The
    primary flow — covered step by step.
  </Card>

  <Card title="White-label app" icon="mobile-screen" href="/apps/overview">
    A manufacturer's own branded app (built on the app-starter) handles
    onboarding with the same QR scan.
  </Card>
</CardGroup>

## Before a user can onboard

The device needs its **QR code** printed and affixed. That QR encodes the product
so the app knows what's being added.

<Card title="Get the QR onto the hardware" icon="qrcode" href="/onboarding/qr-code">
  Download the product QR and stick it on the device.
</Card>

## The shape of the flow

```mermaid theme={null}
flowchart LR
  Q[Scan QR<br/>on device] --> A[Add device<br/>appears in list]
  A --> S[Quick Actions<br/>Setup Device]
  S --> W[Enter Wi-Fi +<br/>connect to device AP]
  W --> C[Send config<br/>device joins network]
```

<Card title="Walk through the official-app flow" icon="arrow-right" href="/onboarding/official-app">
  QR scan → Setup Device → Wi-Fi.
</Card>