- Upgrading ThingsBoard PE to latest 4.2.x (4.2.2)
- Upgrading ThingsBoard PE to 4.2.1.2
- Upgrading ThingsBoard PE to 4.2
Upgrading ThingsBoard PE to latest 4.2.x (4.2.2)
NOTE:
These upgrade steps are applicable for ThingsBoard version 4.2.0+. In order to upgrade to 4.2.2PE you need to upgrade to 4.2.0 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.
ThingsBoard PE package download
Download ThingsBoard PE installation package for Windows: thingsboard-windows-4.2.2pe.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.2.2pe.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, you must run the script below. However, if you are upgrading from version 4.2.1+, 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.2.1.2
NOTE:
These upgrade steps are applicable for ThingsBoard version 4.2.0 or any 4.2.1 patch. In order to upgrade to 4.2.1.2PE you need to upgrade to 4.2.0 first.
This version has known security vulnerabilities that are fixed in newer releases. We recommend upgrading to the latest patch version instead.
ThingsBoard PE package download
Download ThingsBoard PE installation package for Windows: thingsboard-windows-setup-4.2.1.2pe.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.2.1.2pe.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, you must run the script below. However, if you are upgrading from version 4.2.1.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
Upgrading ThingsBoard PE to 4.2
ThingsBoard PE package download
Download ThingsBoard PE installation package for Windows: thingsboard-windows-setup-4.2pe.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.2pe.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 version 4.1, you must run the script below
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat
Start the service
1
net start thingsboard