Stand with Ukraine flag
Pricing Try it now
Community Edition
Getting Started Documentation Guides Installation Architecture API

Frequently Asked Questions

Open Source IoT Platform

General
AI Capabilities
Deployments & Limits
Security & Compliance
Support & Assistance
What is ThingsBoard Community Edition?

ThingsBoard is an IoT platform for data collection, processing, visualization, and device management. It enables you to accelerate development and lower costs by providing out-of-the-box components and APIs while maintaining full control over your solution and data.

ThingsBoard Community Edition (CE) is a free, open-source IoT platform for collecting, storing, and analyzing data from IoT devices. It is designed for developers and organizations that want full control over their own IoT infrastructure and source code without any licensing fees.

Learn more about the platform's architecture in our What is ThingsBoard? guide, or jump straight to the Getting Started Guide to build your first project.

Is ThingsBoard Community Edition free?

Yes, it is completely free, with no licensing fees or hidden costs.

What's the difference between Community and Professional Edition?

Community Edition (CE) is a free, open-source platform suitable for development, testing, and production use without licensing costs. It includes essential features for IoT device management, data collection, visualization, and rule processing.

Professional Edition (PE) includes all CE features and offers advanced capabilities such as white-labeling, role-based access control (RBAC), platform integrations, solution templates, scheduler, and enterprise support.

See the PE product page for a detailed feature comparison table.

How do I get started with ThingsBoard?

Install ThingsBoard CE locally by following our installation guide.

To connect your first device and build dashboards, explore the Getting Started Guide.

Are there API rate limits?

ThingsBoard Community Edition does not have built-in API rate limits; however, system performance and request handling are subject to the limitations of the infrastructure on which it is hosted.

Are there device limits?

No, the Community Edition does not impose programmatic device limits. The number of devices you can connect is only limited by your server's hardware resources.

The ThingsBoard platform is designed to be horizontally scalable. By utilizing a consistent-hashing load balancing algorithm between cluster nodes, the system ensures high availability and performance. Actual capacity depends on your specific usage scenarios and data throughput requirements.

For instance, even a cluster of commodity hardware can support several million devices connected via MQTT.

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 cannot afford the overhead of embedding a third-party SDK. ThingsBoard provides a simple API over common IoT protocols, allowing you to choose any client-side library you prefer or use your own. Some useful references include:

Where can I host ThingsBoard?

You can host ThingsBoard in the cloud, on-premises, or locally on your laptop, PC, or even a Raspberry Pi. We recommend getting started with a Docker installation:

You can also take a look at the cluster setup guide.

Can I use Community Edition for commercial projects?

Yes. CE is licensed under Apache 2.0, allowing commercial use without restrictions. You can build, sell, and deploy commercial products on CE.

Can I migrate from CE to PE?

Yes, you can migrate from ThingsBoard Community Edition to Professional Edition without losing telemetry data and/or configurations. The upgrade process preserves your existing setup, ensuring a seamless transition.

However, please note that any custom modifications made directly to the source code of the Community Edition will be removed during the upgrade process.

See the ThingsBoard instructions for upgrading from Community Edition. Back up your data before starting.

How can I check which version of ThingsBoard I’m currently using?

The easiest way is to log in as SysAdmin. On the home page, you will find a widget in the bottom-left corner of the screen showing the current platform version and whether an upgrade is available.

Can I integrate with third-party systems?

Yes, you can integrate ThingsBoard Community Edition with third-party systems through REST APIs or Rule Engine.

Does ThingsBoard support white-labeling?

No, white-labeling is available only in the Professional Edition.

Can I replace the default ThingsBoard logo in the menu?

The Community Edition does not include a built-in white-labeling feature. However, it is technically possible to replace the default ThingsBoard logo by modifying the source code and rebuilding the platform. This requires development expertise and familiarity with ThingsBoard’s codebase. Please note that such changes will need to be reapplied after each upgrade of the platform.

If you need a more streamlined and configurable option, we recommend considering the Professional Edition. With Professional Edition, you can effortlessly upload your own logo and favicon, customize login and system pages, adjust colors and branding palettes, and even tailor email templates, translations, and custom menus - all directly from the user interface, without touching the code. This empowers your organization to deliver a fully branded, professional-grade experience to your customers and tenants in just a few clicks.

More details: PE White-Labeling Guide.

Can I try Professional Edition before purchasing?

Yes, use the Free plan. This includes access to all PE features for evaluation, including add-ons - Edge computing and Trendz.

Where can I find the source code?

The source code is available on GitHub. You can fork, modify, and contribute to the project under the Apache 2.0 license. It is free for both personal and commercial usage, and you can deploy it anywhere.

Can I contribute to ThingsBoard?

Yes! Pull requests and contributions are welcome on GitHub.

Load more FAQ
Does ThingsBoard support AI integration?

Yes, ThingsBoard includes an AI Request node in the Rule Engine that allows integration with AI services like OpenAI, Azure OpenAI, and custom AI endpoints.

Can I use AI for predictive maintenance?

Yes, ThingsBoard includes built-in AI integration capabilities. You can use the AI Request node to send telemetry data to machine learning models for predictive analytics, anomaly detection, and maintenance scheduling.

See the predictive maintenance example for implementation details.

Which AI providers are supported?

ThingsBoard supports a variety of AI providers, including, but not limited to, OpenAI, Azure OpenAI, and custom API endpoints. Check the AI models page for more details.

Can I train custom ML models with ThingsBoard data?

Yes, export historical telemetry via REST API or data export features (PE) to train models externally. Deploy trained models as API endpoints and integrate them using the AI Request node.

Are there examples of AI use cases?

Yes, see documentation for examples including anomaly detection, and natural language processing.

Do I need a separate AI subscription?

ThingsBoard integration is included, but you need subscriptions to external AI services (OpenAI, Azure, etc.) if using those providers. Custom AI endpoints are entirely under your control.

Where can I install ThingsBoard?

Community Edition can be installed on:

  • On-premise servers or virtual machines. Docker and Kubernetes deployments are supported.
  • Cloud platforms: AWS, Microsoft Azure, DigitalOcean, Google Cloud Platform.
Does ThingsBoard support clustering?

Yes, clustering is supported in all deployment options.

See cluster setup guide for configuration details.

What are the hardware requirements?

Minimum: 2 CPU cores, 4GB RAM for testing.

Recommended for production: 8+ CPU cores, 16GB+ RAM. Requirements scale with device count and message volume.

How many devices can ThingsBoard handle?

There are no programmatic software limits on the number of devices in the Community Edition. The capacity of your system depends entirely on your hardware resources, database configuration, and deployment architecture (standalone vs. cluster).

A single modern server can typically handle tens of thousands of devices, while clustered deployments can scale to support millions of concurrent connections.

Where does ThingsBoard store data?

ThingsBoard supports two database approaches:

  • Pure SQL: PostgreSQL database which is default and recommended for development and production environments with a reasonable load (< 5000 msg/sec).
  • Hybrid database: PostgreSQL + Cassandra for 1M+ devices in production or high data ingestion rate (> 5000 msg/sec).
Does ThingsBoard support multi-tenancy?

Yes, the ThingsBoard Community Edition supports multi-tenancy out of the box.

Does ThingsBoard support OTA (Over-the-Air) firmware updates?

Yes, ThingsBoard supports OTA (Over-the-Air) firmware updates.

Do you charge for API requests?

No. Community Edition has no charges or limits on API requests. However, performance depends on your server capacity and infrastructure.

Is there a mobile app for ThingsBoard?

Yes. ThingsBoard Mobile Application is free and open-source (Apache 2.0 license). It's available for iOS and Android and works with ThingsBoard CE Server.

Load more FAQ
Is my ThingsBoard instance secure?

Yes, but security depends on your deployment setup and infrastructure.

ThingsBoard provides device authentication, encrypted communication (SSL/TLS), role-based access control, and audit logging.

Does ThingsBoard support encryption?

Yes, the Community Edition includes transport encryption (TLS/SSL).

For data-at-rest encryption, configure database-level encryption. See security documentation for setup instructions.

Does ThingsBoard support SSO/OAuth?

Yes, the Community Edition includes SSO (Single Sign-On) and OAuth functionality.

See security documentation for setup instructions.

Can I store ThingsBoard data in my preferred region?

Yes, you have full control over where your data is stored.

How are devices authenticated?

ThingsBoard supports multiple authentication methods: access tokens, X.509 certificates, and username/password. Each device receives unique credentials. See device authentication options available.

Does ThingsBoard support role-based access control (RBAC)?

Community Edition supports a straight-forward security model with three main roles: System administrator, Tenant administrator, and Customer user. A system administrator is able to manage tenants, while a tenant administrator manages devices, dashboards, customers, and other entities that belong to a particular tenant. Customer user is able to view dashboards and control devices that are assigned to a specific customer.

Is ThingsBoard compliant with regulations (GDPR, etc.)?

Compliance depends on your hosting environment and data security practices.

Can I integrate with external authentication providers?

Yes, ThingsBoard supports OAuth2, LDAP, and SAML integration.

Are there audit logs?

Yes, ThingsBoard logs user actions.

Load more FAQ
What support is available for ThingsBoard?

The ThingsBoard team does not provide dedicated support for Community Edition users. Support is community-driven through GitHub (report issues, contribute), Stack Overflow (developer questions), Documentation (guides and tutorials), Youtube channel (tutorials).

Do you offer professional services?

Yes, ThingsBoard offers consulting, custom development, learning resources, and deployment assistance. Contact us to discuss your requirements.

How do I report a bug?

Report bugs on GitHub Issues. Include detailed reproduction steps, logs, and system information. Community members and maintainers will investigate.

Are there training resources?

Yes, comprehensive documentation, video tutorials, and sample projects are available. Professional services include custom training programs. See learning resources for more.

Can I get help with deployment?

Yes, professional services include deployment assistance, architecture review, and production setup. Contact us to discuss your deployment needs.