Skip to content

Cookie preferences

We use cookies for our own analytics and to see how our campaigns perform. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details.

Security, load balancing and remembering your cookie choice.

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

Show us which of our ad campaigns bring visitors to the site (Google Ads).
© 2026 The ThingsBoard Authors
 
Try for free

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

Provision customers and users

ThingsBoard Edge inherits user access from the ThingsBoard server automatically. Customers and users cannot be created directly on Edge. All user management is performed on the server, and the relevant accounts are propagated to Edge once an Edge instance is assigned to a customer.

User access model

Section titled “User access model”

Two types of users can log in to ThingsBoard Edge:

  • Tenant Administrator: All Tenant Administrators on the ThingsBoard server can log in to any connected Edge instance without additional configuration. They can create and delete devices on Edge and have read access to all other entities available on that instance.
  • Customer User: A Customer User can log in to Edge only if the Edge instance has been assigned to their Customer account on the server. Once assigned, they can view only the entities that are assigned to both the Edge instance and their Customer account. An entity assigned only to the Edge, or only to the Customer, is not visible to Customer Users.

Create a customer and user on the server

Section titled “Create a customer and user on the server”

Before assigning an Edge instance to a customer, make sure the customer account and its users exist on the server.

  1. Log in to the ThingsBoard server and go to Customers. Click Add customer (+) and enter the customer details.

  2. Open the customer and go to the Users tab. Click Add user (+), enter the user’s email address, and assign a role.

  3. Click Add. An activation email is sent to the user. The user must activate their account before they can log in to Edge.

For details, see Customers and Users.

Assign an Edge instance to a customer

Section titled “Assign an Edge instance to a customer”
  1. Log in to the ThingsBoard server and go to Edge management → Instances.
  2. Click the Edge instance to open the context menu and select Assign to customer.
  3. Select the customer from the dropdown and click Assign.
    All Customer Users of the selected customer can now log in to Edge and view entities assigned to both the Edge instance and their customer account.

Select Make Edge public from the context menu to make the Edge instance accessible to all customers rather than a specific one.

Access permissions

Section titled “Access permissions”

The table below summarizes what each user type can do on a connected Edge instance.

Role Create and edit Delete Read
Tenant Administrator Devices Devices All entities on Edge
Customer User — — Entities assigned to both the Edge instance and their customer account

Remove customer assignment

Section titled “Remove customer assignment”

Removing the customer assignment revokes Customer User access to Edge immediately. Tenant Administrator access is not affected.

  1. Log in to the ThingsBoard server and go to Edge management → Instances.
  2. Click the Edge instance to open the context menu and select Make Edge private.
  3. Confirm the action.
    Customer Users of the previously assigned customer can no longer log in to the Edge instance.
© 2026 The ThingsBoard Authors ·