Guides

Enroll a device

Complete guide to enrolling devices from setup to secure connection.

Prerequisites

Before enrolling a device you need: an active Optra organization, a DTDL model assigned to the device type, and an API key with device write permissions.

Step 1: Register the device

Use the Optra API or the platform UI to create a device record. Assign a DTDL model and set the device identifier.

Step 2: Generate device credentials

Download the provisioning certificate from the device detail page. This certificate is used for mutual TLS authentication.

Step 3: Configure the device

Upload the certificate to the device and configure the MQTT endpoint:

mqtt://{org-id}.devices.optra.io:8883

Step 4: Verify connection

Power on the device. The status indicator in the platform will turn green when the device is connected and sending telemetry.