Skip to main content

devices

devices — ɳSelf documentation.

Devices Plugin

IoT device enrollment and trust management with command dispatch and telemetry ingestion. Pro plugin.

Requires: Basic license tier or higher. nself license set nself_pro_...

Install

nself license set nself_pro_xxxxx...
nself plugin install devices

What It Does

Handles IoT device enrollment, identity trust, and lifecycle management via a token-based registration flow. Once enrolled, devices can receive commands dispatched from the API and submit telemetry data for storage and querying. All device events, enrollment, command acknowledgement, disconnection, are recorded in a structured event log with configurable telemetry retention.

Configuration

Env VarDefaultDescription
DEVICES_PORT3603Port the Devices plugin service listens on
DEVICES_ENROLLMENT_TOKENnoneShared secret used during initial device enrollment
DEVICES_TELEMETRY_RETENTION90Number of days to retain telemetry data

Ports

PortPurpose
3603Devices plugin HTTP service

Database Tables

5 tables added to your Postgres database.

  • np_devices_registry: Enrolled device records and metadata
  • np_devices_trust: Device trust certificates and enrollment tokens
  • np_devices_commands: Queued and acknowledged commands per device
  • np_devices_telemetry: Ingested telemetry data points
  • np_devices_events: Device lifecycle and connection event log

Nginx Routes

RouteDescription
/devices/Proxied to Devices plugin service on port 3603