Getting started guides

Hello world

Learn how to collect data from IoT devices using MQTT, HTTP, or CoAP and visualize it on a simple dashboard.

mqtt http coap visualization helloworld

Working with IoT dashboards

Learn how to perform basic operations over Dashboards.

dashboards

Getting started with Rule Engine

Learn about ThingsBoard rule engine and typical use cases you can implement. Review Hello World example and learn how-to enable filtering of incoming telemetry messages.

device management attributes

Key concepts for working with the main functions of ThingsBoard

In this intro video, we kick off a tutorial series on ThingsBoard. Together, we'll explore key features and build a step-by-step smart dashboard to collect, visualize, and monitor data from office-integrated IoT devices.

Practical Lesson 1. Adding an entity and visualizing it on the Dashboard

We will create your first dashboard in ThingsBoard. Add Office A as an asset, define its contact information as attributes, and visualize it using an Information card widget.

Practical Lesson 2. Adding devices and visualizing their telemetry on the Dashboard

Time to connect our devices! In this video, we'll add three devices, link them to Office A, simulate telemetry data using the Rule Engine, and display it on the dashboard.

Practical Lesson 3. Time window in ThingsBoard

Learn what a Time window feature is in ThingsBoard and how to set time intervals for working with telemetry data.

Practical Lesson 4. Visualizing device locations with Image Map widget

Learn how to create an Image Map widget to display device locations directly on the office floor plan.

Practical Lesson 5. Part 1. States & Multi-Level Dashboard Hierarchy

Mastering states in ThingsBoard! In this tutorial, we will create separate states for each sensor, configure actions to navigate between them, and set up the air sensor state to monitor temperature, humidity, and CO₂ levels in the office.

Practical Lesson 5. Part 2. Configuring States for Energy & Water Monitoring

Expanding our dashboard with more states! In this tutorial, we will configure states for monitoring power and water consumption.

Practical Lesson 6. Sharing Your Dashboard with Customer

Time to share dashboard data with your customers. In this guide, we’ll add customers, configure their permissions for dashboard data.

Connect devices using ThingsBoard HTTP API

Learn how to connect your devices using HTTP protocol and ThingsBoard built-in payload format.

http connect

Connect devices using ThingsBoard MQTT API

Learn how to connect your devices using MQTT protocol and ThingsBoard built-in payload format.

mqtt connect

Connect devices using ThingsBoard MQTT Sparkplug API

Learn how to connect your devices using MQTT Sparkplug protocol and ThingsBoard built-in payload format.

sparkplug connect

Connect devices using ThingsBoard LwM2M API

Learn how to connect your devices using LwM2M protocol and ThingsBoard built-in payload format.

lwm2m connect

Connect devices using ThingsBoard CoAP API

Learn how to connect your devices using CoAP protocol and ThingsBoard built-in payload format.

coap connect

Connect devices through ThingsBoard IoT Gateway

Learn how to deploy IoT Gateway in your local network and route messages from your devices to the cloud.

gateway connect

ThingsBoard Integrations basics

Learn about ThingsBoard Integrations feature and how you can use it to connect devices and apps that use custom payload formats.

ThingsBoard Integrations vs IoT Gateway

Learn the differences between the Platform Integrations and IoT Gateway.

Connect devices with custom payload using ThingsBoard HTTP Integration

Convert existing protocols and payload formats to ThingsBoard message format.

http connect

Connect devices with custom payload using ThingsBoard MQTT Integration.

Connect to external brokers and consume MQTT data stream

mqtt connect

Connect devices with custom payload using ThingsBoard Kafka Integration.

Connect to external brokers and consume Kafka data stream

kafka connect

Connect SigFox devices using TB PE Integration

Learn how to route messages from Sigfox backend to ThingsBoard and decode binary device payloads.

sigfox connect

Connect LoRaWAN devices using TheThingsStack

Learn how to route messages from TheThingsStack backend to ThingsBoard and vise-versa.

ttn connect

Connect OPC-UA servers to ThingsBoard

Learn how to connect OPC-UA devices to ThingsBoard.

opcua connect

Connect LoRaWAN devices using Actility ThingPark

Learn how to route messages from ThingPark to ThingsBoard and vise-versa.

Connect devices through AWS IoT

Learn how to connect to AWS IoT broker, transform the incoming messages and generate the downlinks using ThingsBoard.

Connect devices through AWS Kinesis

Learn how to connect to AWS Kinesis stream, transform the incoming messages and generate the downlinks using ThingsBoard.

Connect devices through IBM Watson IoT

Learn how to connect to IBM Watson IoT broker, transform the incoming messages and generate the downlinks using ThingsBoard.

Connect devices through Azure Event Hub

Learn how to connect to Azure Event Hub, transform the incoming messages and generate the downlinks using ThingsBoard.

Connect devices through Azure IoT Hub

Learn how to connect to Azure IoT Hub and transform the incoming messages using ThingsBoard.

Devices uses TCP protocol

How to connect to ThingsBoard TCP-server, transform the incoming messages and generate the downlinks using ThingsBoard.

Connect TCP devices

Devices uses UDP protocol

How to connect to ThingsBoard UDP-server, transform the incoming messages and generate the downlinks using ThingsBoard.

Connect UDP devices

Connect Tektelic LoRaWAN sensors using TEKTELIC KONA Core Network Server

Learn how to route messages from TEKTELIC KONA Core Network Server to ThingsBoard.

Tektelic connect

Connect smart devices through Tuya Smart

Learn how to connect smart devices using Tuya Smart to ThingsBoard.

Connect OPC-UA devices through SIA Connect

Learn how to connect OPC-UA devices using the SIA Connect to the ThingsBoard.

Validate incoming telemetry

Learn how to configure Rule Engine to discard invalid telemetry readings based on JavaScript filter function.

Telemetry delta calculation

Learn how to calculate telemetry delta readings using the Calculated fields feature.

Data function based on telemetry from 2 devices

Learn how to generate a new telemetry value based on telemetry readings from multiple devices using the Calculated fields feature.

Transform incoming telemetry

Learn how to configure Rule Engine to transform incoming telemetry based on JavaScript function before it is stored to the database.

Transform telemetry using previous record

Learn how to configure Rule Engine to calculate “delta” of the counter readings based on current and previous reading.

Create & clear alarms

Learn how to configure Rule Engine to create and clear alarms based on incoming data from devices.

Working with Alarm details

Learn how to configure Alarm Details function in Alarm nodes and how to add an Alarm widget to the dashboard.

Send email on alarm

Learn how to configure Rule Engine to send email when new alarm is created.

Send email to customer

Learn how to configure Rule Engine to send email to the customer of the assigned device.

Notifications and Alarms on your smartphone using Telegram Bot

Learn how to configure Rule Engine to send notification using Telegram Bot when new alarm is created.

Create alarm when the device is offline

Learn how to create an alarm when the device is offline for a certain period of time using RuleEngine.

Check relation between Entities

Learn how the Check Relation node can be used to check the relation between Entities.

RPC Request to related Device

Learn how to send a remote request call to a Related Device using Rule Engine.

Using REST API to get weather data

Learn how to use REST API to get weather data in a specified location.

Add & remove devices to group dynamically

Learn how to how to dynamically add & remove device from the device group based on incoming data from device.

Send data to external MQTT brokers

Connect to external brokers and send MQTT data stream

Using queues for synchronization

Learn how to use Rule Engine 2.5 queues for message processing synchronization.

Using queues for message reprocessing

Learn how to use Rule Engine 2.5 queues for message reprocessing in case of failure or timeout.

Aggregate incoming data stream

Calculate total water consumption in the building based on readings from multiple water meters within a building.

aggregation water meter analytics rule engine

Aggregate latest telemetry values periodically

Calculate average temperature in the warehouse based on readings from multiple temperature sensors.

average temperature analytics rule engine

Predict timeseries

Build prediction model based on vibration of water pump

analytics forecast prediction

Connectivity status

Learn how to track connectivity status of the devices: connected, disconnected, active, inactive

Audit log

Learn how to track user actions in order to keep audit log.

API limits

Learn how to control API usage, by limiting number of requests from single host during single time unit (Minutes, Hours, etc.)

White-labeling

Learn how to configure your company or product logo and color scheme in 2 minutes with zero coding efforts.

Device and Asset groups

Learn how to work with entity groups and perform bulk operations

Scheduler

Learn how to schedule various types of events and trigger actions.

Reporting

Learn how to schedule and generate reports based on existing dashboards.

Google OAuth example

Learn how to step-by-step setup OAuth with Google.

OAuth0 OAuth example

Learn how to step-by-step setup OAuth with OAuth0.

OAuth0 Okta example

Learn how to step-by-step setup OAuth with Okta.

OAuth0 Azure Active Directory example

Learn how to step-by-step setup OAuth with Azure Active Directory.

How to Contribute

Learn how to contribute to Thingsboard

How to contribute your device integration guide

Learn how to contribute to Thingsboard

Rule Node Development Guide

Learn how to customize and create custom rule nodes

Widgets Development Guide

Learn how to customize and create custom widgets