Stop the war

Support Ukraine

Try it now Pricing
PE Edge
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application
Installation > Step 1 - Provision Edge on Cloud
Getting Started Documentation
Architecture API FAQ

On this page

Provision ThingsBoard Edge on ThingsBoard PE server

Step 1: Obtain and configure license key

You can use ThingsBoard Edge software based on a license subscription. We assume you have already chosen your subscription plan or decided to purchase a perpetual license. If not, please navigate to pricing page to select the best license option for your case and get your license. See How-to get pay-as-you-go subscription or How-to get perpetual license for more details.

Once you get the license secret, please put it to a safe place. We will use it for ThingsBoard Edge provisioning in the next steps.

Step 2: Provision the edge on ThingsBoard server

In order to connect ThingsBoard Edge you must create Edge entity on the ThingsBoard server first.


You can create Edge entity on ThingsBoard server in case you are using 3.3 version or higher.

Create edge entity

Please make sure you have ThingsBoard Edge license key from Step 1 in front of you.

  • Login to your ThingsBoard PE instance and open "Edge groups" page.
  • Click on the icon "Open" of the group "All".
  • Click on the "+" icon in the top right corner "Add edge".
  • Input edge name and license key (from Step 1). For example, "My New Edge" and "Bsn3L4B089aXXZEiwf2glid". Additionally, please update cloud endpoint if required - this URL should be accessible by the edge. If edge is running in a docker container "localhost" is always wrong. It must be IP address of the machine where ThingsBoard PE is running and accessible by the edge container. If you are using ThingsBoard Cloud server to evaluate edge please set it as Click "Add" to add the edge.
  • Now your edge should be listed first, since table sort edges using created time by default.

Copy Edge credentials

Once you have created Edge entity Edge key and Edge secret will be autogenerated for this edge. You will use these credentials to connect edge to the cloud.

  • Click "Copy Edge key" and "Copy Edge secret" in edge details to copy your edge credentials to the clipboard and store them to some place, these values will be used in further steps.

Next steps

Once ThingsBoard Edge provisioned on ThingsBoard server please follow Step - 2 from Installation Guide - this guide will help you to install ThingsBoard Edge and connect it to ThingsBoard server.