> For the complete documentation index, see [llms.txt](https://help.aximo.autify.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.aximo.autify.com/settings/registered-devices.md).

# Manage registered devices

**Registered Devices** is a settings page for registering your computer or a physically connected iOS or Android phone as a test execution target in Aximo. While a registered device is connected to Aximo with the CLI, registrations on the **Desktop** tab can be selected from the **Desktop** tab when you start sessions, bound to desktop cases, and assigned to plans that include desktop cases. Registrations on the **Local Device** tab can be used from the **Local Device** tab in new sessions to run on a real mobile device.

{% hint style="warning" %}

* **Registered Devices** appears only when the bring your own device (BYOD) feature is enabled for the organization. Customers cannot enable BYOD themselves. To request enablement, contact your sales representative.
* You need an API key to register a device.
* Devices registered on the **Desktop** tab are used for **Desktop** execution, desktop case binding, and plan assignment.
* Devices registered on the **Local Device** tab are iOS or Android phones and are used from the **Local Device** tab in new sessions.
  {% endhint %}

## Open registered devices

1. In the lower-left corner of the screen, click the account icon, then click **Settings**.
2. In the left menu, click **Registered Devices**.

On the page, you can check the following information for each registered device on the selected tab.

| Item      | Description                                                  |
| --------- | ------------------------------------------------------------ |
| Name      | The registered device name                                   |
| Platform  | `windows`, `macos`, `linux`, `android`, or `ios`             |
| Status    | **Online** or **Offline**                                    |
| Last Seen | The date and time when the device was last online or offline |
| Created   | The date when the device was registered                      |

## Register a device

Choose the registration flow that matches where you want to run the session.

* **Desktop**: run tests in a browser on your own computer
* **Local Device**: run mobile sessions on a physically connected iOS or Android phone

### Register a Desktop device

1. If you do not have an API key yet, see [Manage API keys](/settings/api-key-management.md) to create one.
2. On the **Registered Devices** page, open the **Desktop** tab, then click **Register Desktop**.
3. On the machine to register, install the CLI.

   ```bash
   npm i -g @autifyhq/aximo-cli
   ```
4. On the machine to register, set the API key in the `AXIMO_API_KEY` environment variable.

   ```bash
   export AXIMO_API_KEY=your-api-key
   ```
5. On the machine to register, specify a device name and register it.

   ```bash
   aximo device register --name 'My PC'
   ```
6. On the machine to register, connect to Aximo.

   ```bash
   aximo device connect
   ```
7. Return to the **Registered Devices** page and confirm that the added device appears in the list.

### Register a Local Device

1. If you do not have an API key yet, see [Manage API keys](/settings/api-key-management.md) to create one.
2. On the **Registered Devices** page, open the **Local Device** tab, then click **Register Mobile Device**.
3. On the machine to register, install the CLI.

   ```bash
   npm i -g @autifyhq/aximo-cli
   ```
4. On the machine to register, set the API key in the `AXIMO_API_KEY` environment variable.

   ```bash
   export AXIMO_API_KEY=your-api-key
   ```
5. On the machine to register, specify a device name and register the phone.

   ```bash
   aximo mobile register --name 'My phone' --platform android
   ```

   Use `--platform ios` to register an iPhone.
6. On the machine to register, connect the phone to Aximo.

   ```bash
   aximo mobile connect
   ```
7. Return to the **Registered Devices** page and confirm that the added device appears in the list.

{% hint style="info" %}
Use the **Local Device** tab in new sessions for registered iOS or Android phones. Use the **Mobile** tab when you want a Device Farm device instead.
{% endhint %}

While the device is connected, its status becomes **Online** and **Last Seen** is updated.

## Delete a registered device

1. On the **Registered Devices** page, find the device you want to delete.
2. In the device row, click the delete icon.
3. In the confirmation dialog, click **Remove**.

{% hint style="warning" %}
Removed devices cannot be restored. To use the same machine again, register and connect it again.
{% endhint %}

## Further reading

* [Manage API keys](/settings/api-key-management.md)
* [Create a test session](/test-case-creation/create-test-session.md)
* [Create cases](/test-case-creation/create-test-case.md)
* [Manage plans](/test-execution-and-plans/test-plan-specifications.md)