Upgrading ThingsBoard PE to latest 4.3.x (4.3.1)
NOTE:
These upgrade steps are applicable for ThingsBoard version 4.2.1+. In order to upgrade to 4.3.1PE you need to upgrade to 4.2.1.x first.
This release includes a framework upgrade (Angular 18 → 20). The core platform remains fully backward compatible and no upgrade scripts are required. However, custom UI code (widgets or custom CSS) that relies on internal component structure or CSS variable names may break. This can affect up to ~1% of users with heavy customizations. We recommend testing custom UI in a staging environment before upgrading.
Compatibility check before upgrading
If you are using Edge PE or Trendz Analytics together with ThingsBoard, verify that your target ThingsBoard version is compatible with the currently installed versions of these components. Upgrade them if required to ensure compatibility.
- Edge PE: Releases table
- Trendz Analytics: Releases table
ThingsBoard PE service upgrade
-
Change the version of the
thingsboard/tb-pe-nodeandthingsboard/tb-pe-web-reportin thedocker-compose.ymlfile to the 4.3.1PE. -
Execute the following commands:
1
2
3
docker pull thingsboard/tb-pe-node:4.3.1PE
docker pull thingsboard/tb-pe-web-report:4.3.1PE
docker compose stop thingsboard-pe
If you are upgrading from 4.2.1+, you must run the script below. However, if you are upgrading from version 4.3.0+, DO NOT run the upgrade script; proceed directly to starting the service.
1
docker compose run --rm -e UPGRADE_TB=true thingsboard-pe
1
docker compose up -d
Upgrading ThingsBoard PE to 4.3.0.1
NOTE:
These upgrade steps are applicable for ThingsBoard version 4.2.1.x or any 4.3.0 patch. In order to upgrade to 4.3.0.1PE you need to upgrade to 4.2.1.x first.
This version has known security vulnerabilities that are fixed in newer releases. We recommend upgrading to the latest patch version instead.
Compatibility check before upgrading
If you are using Edge PE or Trendz Analytics together with ThingsBoard, verify that your target ThingsBoard version is compatible with the currently installed versions of these components. Upgrade them if required to ensure compatibility.
- Edge PE: Releases table
- Trendz Analytics: Releases table
ThingsBoard PE service upgrade
-
Change the version of the
thingsboard/tb-pe-nodeandthingsboard/tb-pe-web-reportin thedocker-compose.ymlfile to the 4.3.0.1PE. -
Execute the following commands:
1
2
3
docker pull thingsboard/tb-pe-node:4.3.0.1PE
docker pull thingsboard/tb-pe-web-report:4.3.0.1PE
docker compose stop thingsboard-pe
If you are upgrading from 4.2.1+, you must run the script below. However, if you are upgrading from version 4.3.0.x, DO NOT run the upgrade script; proceed directly to starting the service.
1
docker compose run --rm -e UPGRADE_TB=true thingsboard-pe
1
docker compose up -d