Upgrade instructions
Select your deployment type and follow the upgrade guide for your target version
Version history
Section titled Version historySelect a card above to open the upgrade guide for your deployment type, then follow its steps for the target version. Each guide includes instructions for pulling the new image and running the upgrade script.
The table below lists all supported upgrade paths. Versions must be upgraded sequentially — you cannot skip versions.
| Target version | Upgrade from | Notes |
|---|---|---|
| 2.3.0PE | 2.2.0PE | |
| 2.3.0PE | TBMQ 2.3.0 (CE) | See CE-to-PE migration below |
| 2.2.0PE | TBMQ 2.2.0 (CE) | See CE-to-PE migration — third-party changes apply |
Upgrade from TBMQ to TBMQ PE
Section titled Upgrade from TBMQ to TBMQ PEYou can migrate from TBMQ to TBMQ PE of the same version. For example, TBMQ 2.3.0 can be upgraded to TBMQ PE 2.3.0. Cross-version migration (e.g. TBMQ 2.2.0 to TBMQ PE 2.3.0) is not supported — upgrade TBMQ to the target version first, then migrate to TBMQ PE.
Third-party component updates (CE v2.2.0 → PE v2.2.0 only)
Section titled Third-party component updates (CE v2.2.0 → PE v2.2.0 only)The following changes apply only when migrating from TBMQ v2.2.0 to TBMQ PE v2.2.0. They do not apply to v2.3.0 and later.
These updates follow the modernization plan outlined in the Bitnami Image Migration guide.
| Component | TBMQ v2.2.0 | TBMQ PE v2.2.0 | Notes |
|---|---|---|---|
| PostgreSQL | postgres:16 | postgres:17 | Improved performance and resource efficiency. Existing data volumes remain compatible. |
| Kafka | bitnamilegacy/kafka:3.7.0 | apache/kafka:4.0.0 | Migrated from Bitnami to the official Apache Kafka image. New volume paths are required. |
| Redis → Valkey | bitnamilegacy/redis:7.2.5 | valkey/valkey:8.0 | Migrated from Bitnami Redis to Valkey. A new volume tbmq-valkey-data is introduced. |
Before starting, create full backups of your environment — including the PostgreSQL database (for example, using pg_dump) and your Kafka and Redis data volumes if you plan to migrate them.
PostgreSQL is upgraded from 16 to 17. Although existing data volumes remain compatible, you must perform a proper database version upgrade (for example, using pg_upgrade) to ensure data integrity.
Kafka and Redis have been migrated from Bitnami images to official open-source alternatives. The new images use different internal data directories and volume mappings, so existing Bitnami volumes cannot be reused directly. You must either migrate your data manually or start from new, empty volumes.
The standard upgrade script updates only the PostgreSQL database schema and does not include data migration logic for Kafka or Valkey.