- TBMQ升级选项
关注 TBMQ Professional Edition？可将TBMQ CE升级至 TBMQ PE。
升级至2.2.0
NOTE:
These steps are applicable for 2.1.0 TBMQ version. In order to upgrade to 2.2.0 you need to upgrade to 2.1.0 first.
关于TBMQ部署中的Bitnami镜像
在TBMQ部署中，我们使用 Bitnami镜像作为PostgreSQL、Redis和Kafka等第三方组件。 The Bitnami team has announced important upcoming changes to their catalog that affect these images.
What’s happening:
- Starting August 28, 2025, the public
docker.io/bitnamiregistry will only provide a small set of “latest” hardened images for development use. - All versioned images will be moved to a temporary legacy registry:
docker.io/bitnamilegacy. These images will remain available but will not receive updates or security patches. - The long-term, supported solution is Bitnami’s new Secure Images (subscription-based).
Temporary solution:
To avoid disruption in your TBMQ deployments, please update your image references from docker.io/bitnami/... to docker.io/bitnamilegacy/....
This ensures that your clusters continue to work after August 28, 2025.
下一步: We are currently evaluating a long-term strategy for TBMQ third-party images. We’ll share the details once the new approach is finalized.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
升级至2.1.0
NOTE:
These steps are applicable for 2.0.0 and 2.0.1 TBMQ versions. In order to upgrade to 2.1.0, your current version should be greater or equal to 2.0.0 version.
拉取TBMQ镜像（可选）
根据当前安装方式拉取2.1.0版TBMQ镜像。
|
|
起始版本（2.1.0起自动检测）
自2.1.0起，升级脚本已移除 fromVersion 参数，不再支持。 2.1.0起，升级脚本会自动检测当前安装版本，并根据预定义的支持版本列表判断是否可继续升级。
请通过页面顶部的选择卡片进入相应文档以继续升级步骤。
升级至2.0.1
NOTE:
These steps are applicable for 2.0.0 TBMQ version. In order to upgrade to 2.0.1 you need to upgrade to 2.0.0 first.
Pull TBMQ image (Optional)
Pull 2.0.1 version TBMQ image depending on your current installation.
|
|
From version
The fromVersion should be set to 2.0.0.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
Upgrading to 2.0.0
NOTE:
These steps are applicable for 1.4.0 TBMQ version. In order to upgrade to 2.0.0 you need to upgrade to 1.4.0 first.
This release of TBMQ introduces significant improvements, including key new features and a migration from PostgreSQL to Redis for storing messages for persistent DEVICE clients. For more details, refer to the architecture documentation.
Before upgrading, it is strongly recommended to back up your PostgreSQL database to ensure data safety. Follow the steps by selecting an appropriate guide from one of the cards on top of the page.
Pull TBMQ image (Optional)
Pull 2.0.0 version TBMQ image depending on your current installation.
|
|
From version
The fromVersion should be set to 1.4.0.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
Upgrading to 1.4.0
NOTE:
These steps are applicable for 1.3.0 TBMQ version. In order to upgrade to 1.4.0 you need to upgrade to 1.3.0 first.
Pull TBMQ image (Optional)
Pull 1.4.0 version TBMQ image depending on your current installation.
|
|
From version
The fromVersion should be set to 1.3.0.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
Upgrading to 1.3.0
NOTE:
These steps are applicable for 1.2.1 TBMQ version. In order to upgrade to 1.3.0 you need to upgrade to 1.2.1 first.
Pull TBMQ image (Optional)
Pull 1.3.0 version TBMQ image depending on your current installation.
|
|
From version
The fromVersion should be set to 1.2.1.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
Upgrading to 1.2.1
NOTE:
These steps are applicable for 1.2.0 TBMQ version. In order to upgrade to 1.2.1 you need to upgrade to 1.2.0 first.
Pull TBMQ image (Optional)
Pull 1.2.1 version TBMQ image depending on your current installation.
|
|
From version
The fromVersion should be set to 1.2.0.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
Upgrading to 1.2.0
NOTE:
These steps are applicable for 1.1.0 TBMQ version. In order to upgrade to 1.2.0 you need to upgrade to 1.1.0 first.
Pull TBMQ image (Optional)
Pull 1.2.0 version TBMQ image depending on your current installation.
|
|
From version
The fromVersion should be set to 1.1.0.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
Upgrading to 1.1.0
NOTE:
These steps are applicable for 1.0.0, and 1.0.1 TBMQ versions.
Pull TBMQ image (Optional)
Pull 1.1.0 version TBMQ image depending on your current installation.
|
|
From version
The fromVersion can be set to either 1.0.0 or 1.0.1 values.
Navigate to the appropriate documentation to proceed with the next upgrade steps by choosing one of the cards on top of the page.
下一步
-
快速入门指南 - 本指南提供 TBMQ 的快速概览。
-
安全指南 - 学习如何为 MQTT 客户端启用认证与授权。
-
配置指南 - 了解 TBMQ 配置文件和参数。
-
MQTT 客户端类型指南 - 了解 TBMQ 客户端类型。
-
与 ThingsBoard 集成 - 了解如何将 TBMQ 与 ThingsBoard 集成。