# TBMQ Cluster

TBMQ Cluster is a self-hosted databases app. Helm chart for deploying TBMQ, an open-source MQTT broker, as a scalable, fault-tolerant Kubernetes cluster. It is open source and self-hosted, installable on Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/4816/tbmq-cluster

## Description

Helm chart for deploying TBMQ, an open-source MQTT broker, as a scalable, fault-tolerant Kubernetes cluster.

## Platform availability

Available on 1 of 10 platforms: Helm.

## Health score

60/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 16 days ago)
- Popular: 58 (776 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 20 (1 serious finding, 1 minor, CI, tests)

## Security check

1 serious finding: A private key is committed in the source code.
Automated checks on commit d9be3f9, 29 Oct 2026. Not an audit.

## Links

- Documentation: https://tbmq.io/docs/
- Official website: https://tbmq.io
- GitHub: https://github.com/thingsboard/tbmq
- Kubernetes (Helm): https://artifacthub.io/packages/helm/tbmq-helm-chart/tbmq-cluster

## Common questions

### Does a TBMQ cluster need a master node?

No, TBMQ cluster nodes are symmetric with no master. They coordinate through Kafka.

### What should I check when TBMQ messages are delayed or missing?

Review TBMQ logs and Kafka consumer lag. The troubleshooting docs include playbooks for connection, delivery, latency, and resource issues.

### Can TBMQ handle very large MQTT deployments?

The provided notes list at least 3M messages per second per single cluster node. In cluster mode, TBMQ is described as supporting over 100M concurrently connected clients.

### Can TBMQ be used for fan-in and fan-out MQTT workloads?

Yes, TBMQ is presented for IoT scenarios and supports fan-in, fan-out, and point-to-point messaging.

---
Source: Our Local Host (https://ourlocalhost.com/app/4816/tbmq-cluster), the self-hosted and open-source app directory.
