Thingsboard Documentation

Documentation for using Thingsboard IoT Platform.

Installing Thingsboard on Windows

This guide describes how to install Thingsboard on a Windows machine. Instructions below are provided for Windows 10/8.1/8/7 32-bit/64-bit.

Hardware requirements

To run Thingsboard and third-party components on a single machine you will need at least 2Gb of RAM (4Gb recommended).

Third-party components installation

Java

Thingsboard service is running on Java 8. If you don’t have Java installed, please download and install Java 8 using this link.

Cassandra

Thingsboard service requires Cassandra database. Instructions listed below will help you to install Cassandra.

image

image

image

image

image

image

image

image

Thingsboard service installation

Provision database schema and initial data

Once Cassandra and Thingsboard services are installed, open “Cassandra CQL Shell” and execute following scripts:

cqlsh> source 'c:\thingsboard\data\schema.cql';
cqlsh> source 'c:\thingsboard\data\system-data.cql';
cqlsh> source 'c:\thingsboard\data\demo-data.cql';
Start Thingsboard service

Now let’s start the Thingsboard service! Open command prompt as an Administrator and execute following command:

net start thingsboard

Expected output:

The Thingsboard Server Application service is starting.
The Thingsboard Server Application service was started successfully.

In order to restart the Thingsboard service you can execute following commands:

net stop thingsboard
net start thingsboard

Once started, you will be able to open Web UI using following link:

http://localhost:8080/

NOTE: Please allow up to 90 seconds for the Web UI to start

Troubleshooting

The log files are located in logs folder (“C:\thingsboard\logs” in our case).

The thingsboard.log file should contain following line:

YYYY-MM-DD HH:mm:ss,sss [main] INFO  o.t.s.ThingsboardServerApplication - Started ThingsboardServerApplication in x.xxx seconds (JVM running for x.xxx)

In case of any unclear errors, use general troubleshooting guide or contact us.

Windows firewall settings

In order to have external access to Thingsboard Web UI and device connectivity (HTTP, MQTT, CoAP) you need to create a new inbound rule with Windows Firewall with Advanced Security.

image

image

image

image

image

image

image

image