Documentation for installation and configuration of ThingsBoard IoT Platform.

What is ThingsBoard License Server?

The ThingsBoard License Server is a proprietary billing solution that allows ThingsBoard Professional Edition (TB PE) customers to easily purchase license keys online. The online payment processing is secured by Stripe, which allows both credit cards and wire transfer.

You may already know that TB PE supports pay-as-you-go subscriptions and perpetual license models. The License Server was introduced in mid-2019, based on our experience of billing first 500 TB PE clients, to bring improvements in the following areas:

The License Server product is designed to be generic and may be used to sell any software products with the pay-as-you-go or perpetual license models. If you are interested to use it for selling your software, please contact us.

Product features

License Server allows purchasing monthly or yearly subscriptions for ThingsBoard. See pricing for more details about available subscriptions. Once you purchase a subscription, you can flexibly upgrade or downgrade your subscription plan. By default, the subscription covers single ThingsBoard PE instance (server process). However, you can add more instances to the same subscription. This allows launching multiple instances that use same subscription credentials in one server cluster. This feature is very useful for container-based setups.

Pay-as-you-go subscriptions are convenient for small companies and start-ups that are getting started with the platform and would like to minimize upfront licensing costs. Most of the subscriptions are limited by the number of devices and/or assets you can create.

License Server allows purchasing perpetual fallback licenses. A perpetual fallback license is a license that allows you to use a specific version of the software without an active subscription for it. When purchasing a perpetual fallback license, you get one year of software updates included. After one year, you can continue using the platform. You can purchase software updates for the subsequent years for additional fee, typically 40% of the initial license cost.

A single perpetual fallback license covers a single ThingsBoard PE instance (server process). For example, if you like to run ThingsBoard PE in an HA mode, you will need at least two licenses.

License Server is collecting Payments via Stripe. This means we use best practices in terms of security and processing of transactions provided by the most popular online payment platform. ThingsBoard has no access to your credit card data. You can cancel your subscription at any time. ThingsBoard also provides the ability to download digital copies copy of the invoices.

License Server allows the administrator to provision coupons. These coupons may be used by partners, distributors and for marketing campaigns.

License Server does not generate license keys based on hardware or VM parameters. License Server client issues periodic license check requests to the License Server. These requests validate that the subscription / perpetual license is valid and the number of launched instances does not exceed subscription threshold. See Architecture for more details.


The License Server Client (e.g. your ThingsBoard PE instance) requires an internet connection to the host: to issue license check requests. In case internet connection to the host is not available for more than 24 hours, License Server Client may shutdown ThingsBoard instance.


The License Server provides REST API for the License Server clients to activate and check licenses.

During the first launch of ThingsBoard PE, built-in License Server Client generates an “Activate Instance Request” to the License Server. This request contains the license key and version info about the current platform installation. License Server lookup the subscription info based on the license key and replies with the instance id, subscription plan data, and some magic bytes. License Client stores this information locally and uses instance id and some magic bytes for the next license check requests.


License Client issues periodic license check requests to the License Server. If those requests are not successful for a configurable period of time (typically 24 hours), the license client will shut down the ThingsBoard PE instance. In case of a successful request, the client may receive an update to the subscription plan data. This may be caused by the update of the subscription plan.


User Guide