- TBMQ upgrade options
Upgrading to 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.
Notice About Bitnami Images in TBMQ Deployments
In our TBMQ deployments, we use Bitnami images for third-party components such as PostgreSQL, Redis, and 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.
Next steps: 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.
Upgrading to 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.
Pull TBMQ image (Optional)
Pull 2.1.0 version TBMQ image depending on your current installation.
|
|
From version (automatically detected since 2.1.0)
Starting from version 2.1.0, the fromVersion parameter has been removed from the upgrade script and is no longer supported. As of 2.1.0, the upgrade script automatically detects the currently installed version and determines whether the upgrade can proceed based on a predefined list of supported versions.
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.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.
Next steps
-
Getting started guide - This guide provide quick overview of TBMQ.
-
Security guide - Learn how to enable authentication and authorization for MQTT clients.
-
Configuration guide - Learn about TBMQ configuration files and parameters.
-
MQTT client type guide - Learn about TBMQ client types.
-
Integration with ThingsBoard - Learn about how to integrate TBMQ with ThingsBoard.