> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://mediakind.ferndocs.com/mkio/how-to/managing-edge-devices/on-board-fleet-devices/terminal-only/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://mediakind.ferndocs.com/_mcp/server.

# On-board edge devices using device terminal only

Connect and register an edge device from its terminal when the installing engineer cannot access the local web UI.

## Prerequisites

* The device has been configured with a Control IP address.

* You can access the device’s terminal via a keyboard and monitor or via SSH.

## Overview of adding the device to MK.IO

This on-boarding process has two parts:

* From the device’s local terminal, copy the Device ID.

* Use the Device ID to register the device via the MK.IO UI.

Once registered, the device is available for monitoring and control through MK.IO, including its web UI.

**Remote on-boarding**

The two steps above do not need to be completed by the same person. In a remote on-boarding scenario, the engineer installing the device can pass the Device ID verbally to an MK.IO user with permission to register it.

### Configure an HTTP proxy (optional)

A proxy only needs to be configured when internet connectivity for MK.IO is only possible via a proxy. Running this command without changing any settings also lets you diagnose connectivity issues.

* Log in to the device’s terminal.

* Run the `control-wizard` command.

* Press P to configure a proxy.

* Enter the Proxy IP Address, Port, Username, and Password.

* Press Enter to apply.

* Proxy settings are tested and results displayed on screen.

* Press Q to quit.

### Obtain the Device ID

The **Device ID** displays on the device’s terminal. Press **Enter** if needed to clear the screen. It also displays when you log in to the device terminal through SSH.

### Add the device using the MK.IO UI

The device must have connected to MK.IO before you can register it. If the device cannot reach MK.IO, see [Troubleshooting on-boarding](/mkio/how-to/managing-edge-devices/on-board-fleet-devices/troubleshooting).

Follow [Add the device using the MK.IO UI](/mkio/how-to/managing-edge-devices/on-board-fleet-devices/common-workflow#add-the-device-using-the-mkio-ui). Enter the **Device ID** in place of the short code.

### Verify on-boarding

You can now [view device information](/mkio/how-to/managing-edge-devices/display-device-information) and [access the remote UI](/mkio/how-to/managing-edge-devices/access-the-remote-device-ui).

### Update device software

Once the device is registered, before commissioning, [update the device software to the latest version](/mkio/how-to/managing-edge-devices/update-device-software).