Devices

Devices are the primary IoT entities in ThingsBoard. They represent physical or virtual things — sensors, controllers, gateways, emulators — that publish telemetry, report attributes, and respond to RPC commands.

1. Navigate to Entities → Devices.
2. Click + and select Add new device.
3. Enter a Name (must be unique within the tenant).
4. Optionally set a Device profile, Label, or Description.
5. If this device will proxy data for other devices, enable Is gateway (see Gateway Devices).
6. Click Add.

A connectivity check dialog opens automatically — use it to verify the connection or close it to continue later.

1. Click the pencil icon next to the device in the list.
2. Update the name, profile, label, firmware, or software version.
3. Click Apply changes.

Click the trash icon next to the device and confirm, or open the device details page and click Delete device.

1. Open the device details page.
2. Click Manage credentials.
3. Select the credential type and fill in the required fields.
4. Click Save.

A gateway device proxies data for multiple downstream devices over a single connection using the Gateway API. Enable gateway mode when creating or editing a device.

Setting	Description
Is gateway	Grants the device access to the gateway topic namespace for proxying downstream devices.
Overwrite activity time	When enabled, the gateway’s own connection activity keeps connected downstream devices in Active state. Useful when downstream devices are connected through the gateway but not actively sending telemetry — RPC commands and shared attribute updates can still be delivered to them.

To enable gateway mode, toggle Is gateway in the device creation form (step 4 of Create a Device) or in the device edit form.

Opening a device reveals a details panel with the following tabs:

Tab	Contents
Attributes	Client, server, and shared key-value pairs (serial number, firmware version, thresholds)
Latest Telemetry	Real-time sensor readings; supports manual entry and deletion by time range
Calculated Fields	Values computed from telemetry or attributes using formulas
Alarm Rules	Conditions, thresholds, and triggers configured for alarm generation
Alarms	Active and historical alarms for this device
Events	Lifecycle events, logs, warnings, and errors
Relations	Directed connections to other entities (assets, dashboards, rule chains)
Audit Logs	History of user actions: creation, updates, deletions
Version Control	Git-based export and restore for backup and collaboration

Verify that the device can communicate with ThingsBoard:

1. Open the device details page and click Check connectivity.
2. Select the protocol (MQTT, HTTP, or CoAP) and your operating system.
3. Copy the generated command and run it in your terminal.

On success, the device status changes from Inactive → Active and telemetry appears under the Latest telemetry tab.

1. Open the device details page.
2. Click Assign device to customer.
3. Select the customer and click Assign.

Only users associated with that customer can access the device and its data.

Open the device details page and click Make device public to expose device data publicly, or Make device private to revoke public access.

• Dashboards — visualize telemetry, attributes, and alarms via widgets
• Rule Engine — process incoming telemetry, trigger alarms, route messages
• Calculated Fields — compute derived values from device data
• Relations — model hierarchies (e.g., Gateway → Contains → Sensor)
• REST API — query, create, and manage devices programmatically