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 package download
Download ThingsBoard PE installation package for Windows: thingsboard-windows-4.3.1pe.zip.
ThingsBoard PE service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
-
Make a backup of previous ThingsBoard PE configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
-
Copy content of the thingsboard-windows-4.3.1pe.zip to the same location.
-
Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
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.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat
Start the service
1
net start thingsboard
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 package download
Download ThingsBoard PE installation package for Windows: thingsboard-windows-setup-4.3.0.1pe.exe.
ThingsBoard PE service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
-
Make a backup of previous ThingsBoard PE configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
-
Run the installation package thingsboard-windows-setup-4.3.0.1pe.exe
-
Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
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.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat
Start the service
1
net start thingsboard