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

# Device binding

> Connect your device to a BRICKS workspace

Before your device can run applications, you need to bind it to a [BRICKS](https://bricks.tools) workspace. Binding links the device to your account so you can manage it from [BRICKS Controller](/controller).

## Bind with a passcode

<Steps>
  <Step title="Open BRICKS Foundation">
    Launch the BRICKS Foundation app on your device. The app displays a 9-character passcode on screen.
  </Step>

  <Step title="Open BRICKS Controller">
    Go to [BRICKS Controller](/controller/devices) and navigate to **Devices** > **Add Device**.
  </Step>

  <Step title="Enter the passcode">
    Enter the 9-character passcode shown on your device and click **Bind**. The device appears in your device list.
  </Step>
</Steps>

<Info>
  The passcode refreshes periodically. If binding fails, wait for a new passcode and try again.
</Info>

## Bind with a QR code

Some devices display a QR code alongside the passcode. Scan the QR code with your phone to open [BRICKS Controller](/controller) with the passcode pre-filled.

## Verify the binding

After binding, your device appears in the [BRICKS Controller](/controller/devices) device list with an online status indicator. You can now:

* Assign applications to the device
* Monitor its status and connectivity
* Send commands and dispatch actions
* Take remote screenshots

## Troubleshooting

| Issue                              | Solution                                                  |
| ---------------------------------- | --------------------------------------------------------- |
| Passcode not accepted              | Wait for a new passcode to generate and try again         |
| Device shows offline after binding | Check the device's network connection and restart the app |
| Device not appearing in Controller | Refresh the device list in BRICKS Controller              |

## Next steps

<Card title="Launch an application" icon="play" href="/foundation/launch-applications">
  Assign an application to your device and start running it.
</Card>