> ## 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 management

> Add, monitor, and control devices from BRICKS Controller

[BRICKS Controller](/controller) provides a centralized dashboard for managing all devices bound to your workspace.

## Adding devices

### Bind a physical device

<Steps>
  <Step title="Open the device on BRICKS Foundation">
    Launch [BRICKS Foundation](/foundation) on the device. A 9-character passcode displays on screen.
  </Step>

  <Step title="Add the device in BRICKS Controller">
    In BRICKS Controller, go to **Devices** > **Add Device**.
  </Step>

  <Step title="Enter the passcode">
    Type the passcode from the device and click **Bind**. The device appears in your device list.
  </Step>
</Steps>

### Create a virtual device

Virtual devices are cloud-based instances that behave like physical devices. Use them for testing and development.

1. Go to **Devices** > **Add Device**
2. Select **Virtual Device**
3. Configure the device name and viewport
4. Click **Create**

## Device list and monitoring

The device list shows all devices in your workspace with their current status:

| Status             | Meaning                                   |
| ------------------ | ----------------------------------------- |
| **Online** (green) | Device is connected and running           |
| **Offline** (gray) | Device is not connected                   |
| **Last alive**     | Timestamp of the device's last connection |

Click on a device to view its details, including hardware info, current application, and connection history.

## Device control

From the device detail page, you can:

* **Refresh** — Reload the application on the device
* **Clear cache** — Clear the application cache and force a full reload
* **Take screenshot** — Capture a screenshot of the device's current display
* **Remote debug** — Inspect application properties in real time (see [remote debugging](/foundation/remote-debug))
* **Debug panel** — Toggle debug panel, logging, and other diagnostic overlays on the device
* **Activity log** — View device event history

## Device groups

Device groups have their own top-level tab in BRICKS Controller (**Device Group**). Use groups to organize devices for batch operations:

1. Go to the **Device Group** tab
2. Click **New Device Group**
3. Add devices to the group
4. Use the group to deploy applications, deploy device settings, or dispatch actions to all devices at once

## Device tokens

Virtual devices have a unique token for API access. Use device tokens to interact with virtual devices programmatically through the [BRICKS CLI](/cli) or the workspace API.

To view a virtual device's token:

1. Click on the virtual device in the device list
2. Go to the **Settings** tab
3. Copy the **Device Token**

## Screenshots

Take remote screenshots of any online device:

1. Select the device from the device list
2. Click **Screenshot**
3. The screenshot appears in the device detail page

Screenshots are useful for monitoring device displays and debugging visual issues.