Skip to content

Cookie preferences

We use cookies for our own analytics, to see how our campaigns perform and, if you allow it, to load content from other services such as the Google site search. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details and our Privacy Policy for how we handle personal data.

Security, load balancing and remembering your cookie choice.

Show us which pages people read, how they find the site and where they get stuck, so we can improve it (Google Analytics, Microsoft Clarity).

Show us which of our ad campaigns bring visitors to the site and remember the campaign or partner link you arrived from (Google Ads, LinkedIn, Meta, partner program). We do not use these cookies to build advertising profiles.

Load the site search from Google when you use it. Google sets its own cookies and shows ads in the search results.
© 2026 The ThingsBoard Authors
180 Try for free Menu

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

North America Data stored in North America Europe Data stored in the European Union

Rather run it yourself? Install on your own servers

Set up ThingsBoard Edge

In this step, you will create an Edge instance record in your ThingsBoard account, install the instance, and access the Edge UI.

Provision Edge

Section titled “Provision Edge”

Before installing Edge software, create an Edge instance record in your ThingsBoard account. This generates the credentials (Edge key and Edge secret) that Edge uses to authenticate on the server.

  1. Log in to your ThingsBoard account as a Tenant Administrator. Use your own credentials or the defaults (tenant@thingsboard.org / tenant).

  2. Go to Edge management > Edges, click Add edge, and select Add new edge.

  3. Enter a name for the Edge and click Add. The new Edge appears at the top of the list, and the Edge created! Check Install & Connect Instructions dialog opens with the installation instructions.

Edges page in Edge management with the Add edge menu open Add edge dialog with the Name field New Edge instance in the Edge instances list

Install ThingsBoard Edge

Section titled “Install ThingsBoard Edge”

The dialog contains ready-to-use commands. They already include the Edge key and Edge secret of this Edge, so you do not need to copy anything by hand.

  1. In the dialog, select the tab for your installation method (Docker, Ubuntu, or CentOS/RHEL) and run the displayed commands to install and start ThingsBoard Edge. The dialog opens on the Agent tab, which is for remote installation with a Remote Agent; you do not need it for this tutorial.

  2. Once Edge starts (this may take a few seconds), open http://localhost:8080 in a browser and log in with your Tenant Administrator credentials. If Edge runs on the same machine as the server and you changed the ports as the instructions suggest, use port 18080 instead.

  3. In the Edge UI, go to Edge > Status. The status is Connected. On the server, the Attributes tab of the Edge shows the server attribute active = true.

Install and connect instructions dialog showing Docker commands with Edge credentials pre-filled

If you cannot use the commands from the dialog, see the manual installation instructions.

Checklist for moving on

Section titled “Checklist for moving on”