Edge
ThingsBoard Edge Documentation
Cloud Professional Edition Community Edition Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application
Try it now Pricing
Getting Started Documentation Installation Architecture API

On this page

FAQ

What is ThingsBoard Edge?

ThingsBoard Edge is a ThingsBoard’s software product for edge computing. It allows bringing data analysis and management to the edge, where the data created. At the same time ThingsBoard Edge seamlessly synchronizing with the ThingsBoard cloud (ThingsBoard Cloud, ThingsBoard Demo, ThingsBoard PE or ThingsBoard CE) according to your business needs. If this is your first experience with the edge we recommend to review what-is-edge and getting started guide. You can find more information on the dedicated page.

How do I get started?

We recommend to install ThingsBoard Edge locally on your laptop or PC using Docker and follow the getting started guide.

Does ThingsBoard Edge require connection to the internet?

No, ThingsBoard Edge does not require connection to the internet. You can use it without internet connection. The only connection required is the one to the ThingsBoard cloud platform over gRPC.

Can multiple tenants or customers access single ThingsBoard Edge on remote location?

ThingsBoard Edge CE is single tenant and(or) single customer. You cannot share ThingsBoard Edge between multiple tenants or customers. And devices from multiple tenants can not be connected to a single ThingsBoard Edge. In this case you’ll need to provision multiple ThingsBoard Edge instances for every tenant or customer.

Can I connect devices from multiple tenants to a single ThingsBoard Edge?

ThingsBoard Edge is single Tenant. You cannot connect devices from multiple tenants to a single ThingsBoard Edge entity. In this case you’ll need to provision multiple ThingsBoard Edge instances for every tenant.

What can I do with ThingsBoard Edge?

With ThingsBoard Edge, you can connect your on-site devices to ThingsBoard Edge, that is installed on-site as well, instead of direct connection to ThingsBoard cloud and get next benefits:

  • Local deployment and storage
    Process and store data from edge (local) devices without connection to the cloud. Push updates to the cloud once connection restored.
  • Traffic filtering
    Filter data from edge (local) devices on the ThingsBoard Edge service and push to cloud only subset of the data for further processing or storage.
  • Local alarms
    React instantly to critical situations on site without connectivity to cloud.
  • Batch update and visualization
    Update thousands of edge configurations in a single click. Monitor local events and timeseries data with a real-time dashboard.

How to connect my device?

ThingsBoard provides MQTT, CoAP, HTTP, and LwM2M protocols support. Existing devices may be connected to the platform using ThingsBoard Gateway. You can find more information on the connectivity page.

Do I need to use an SDK?

No, many IoT devices can’t afford to embed third-party SDK. ThingsBoard Edge provides quite simple API over common IoT protocols. You can choose any client-side library you like or use your own. Some useful references:

What about security?

You can use MQTT (over SSL) or HTTPS protocols for transport encryption.

Each device has unique access token credentials that is used to setup connection. Credentials type is pluggable, so X.509 certificates support is coming soon.

How many devices can ThingsBoard Edge support?

There is no any soft limits on creating devices and assets on the edge side.

But in real case deployment there are couple additional factors, that must be considered to be able host a lot of devices on edge side - hardware, speed of internet connection and gRPC channel bound limits. Edge hardware must be powerful enough to process messages from ‘unlimited’ number of devices and assets. Additionally, speed of internet connection between ThingsBoard Edge and ThingsBoard server must be fast to deliver huge amount of data from ‘unlimited’ number of devices and assets. And last, but not least - payload size and messages rate should be taken into consideration as well - gRPC channel bound limits affects messages delivery rate. ThingsBoard Edge designed in mind as an edge computing service, located in remote locations with possible low bandwidth connectivity, so we do not recommend connecting more than 1000 devices to a single edge.

Where does ThingsBoard Edge store data?

The data is stored in PostgreSQL database. PostgreSQL suites well for storage and querying of entities and local time-series data.

How to get support?

You can use troubleshooting instructions and community resources or contact us and learn more about services we provide.