Upgrading ThingsBoard CE 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.1 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 together with ThingsBoard, verify that your target ThingsBoard version is compatible with the currently installed Edge version. Upgrade it if required to ensure compatibility.
- Edge: Releases table
ThingsBoard CE service upgrade
-
Change the version of the
thingsboard/tb-nodein thedocker-compose.ymlfile to the 4.3.1. -
Execute the following commands:
1
2
docker pull thingsboard/tb-node:4.3.1
docker compose stop thingsboard-ce
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-ce
1
docker compose up -d
Upgrading ThingsBoard CE 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.1 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 together with ThingsBoard, verify that your target ThingsBoard version is compatible with the currently installed Edge version. Upgrade it if required to ensure compatibility.
- Edge: Releases table
ThingsBoard CE service upgrade
-
Change the version of the
thingsboard/tb-nodein thedocker-compose.ymlfile to the 4.3.0.1. -
Execute the following commands:
1
2
docker pull thingsboard/tb-node:4.3.0.1
docker compose stop thingsboard-ce
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-ce
1
docker compose up -d