In order to update ThingsBoard PE please follow these instructions
- Upgrading to 3.8.1
- Upgrading to 3.8
- Upgrading to 3.7
- Upgrading to 3.6.4
- Upgrading to 3.6.3
- Upgrading to 3.6.2
- Upgrading to 3.6.1
- Upgrading to 3.6
- Upgrading to 3.5.1
- Upgrading to 3.5
- Older versions
Upgrading to 3.8.1
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.8. In order to upgrade to 3.8.1 you need to upgrade to 3.8 first.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.8. In order to upgrade to 3.8.1 you need to upgrade to 3.8 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.8.1.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Start the service
1
net start thingsboard
Upgrading to 3.8
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.7. In order to upgrade to 3.8 you need to upgrade to 3.7 first.
Install PostgreSQL contrib package (For CentOS only)
|
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.7.0
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.7. In order to upgrade to 3.8 you need to upgrade to 3.7 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.8.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.7.0
Start the service
1
net start thingsboard
Upgrading to 3.7
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.4. In order to upgrade to 3.7 you need to upgrade to 3.6.4 first.
Important note before upgrading to ThingsBoard 3.7
ThingsBoard backend was migrated to Java 17. Install JDK 17 and ensure that system’s default Java version is set to 17.
Please refer to Step 1 of the corresponding installation guide for detailed instructions:
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.6.4
Start the service
In case Cassandra is installed, ensure that a proper JAVA_HOME parameter is set for cassandra.in.sh include file. As of 3.7.0 release, latest stable Cassandra version does not support Java 17 yet.
In case action is required, you can refer to “you will need to install Java…” section of Cassandra installation guide.
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.4. In order to upgrade to 3.7 you need to upgrade to 3.6.4 first.
Important note before upgrading to ThingsBoard 3.7
ThingsBoard backend was migrated to Java 17. Install JDK 17 and ensure that system’s default Java version is set to 17.
Please refer to Step 1 of the installation guide for detailed instructions.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.7.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.6.4
Start the service
1
net start thingsboard
Upgrading to 3.6.4
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.3. In order to upgrade to 3.6.4 you need to upgrade to 3.6.3 first.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.6.3
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.3. In order to upgrade to 3.6.4 you need to upgrade to 3.6.3 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.6.4.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.6.3
Start the service
1
net start thingsboard
Upgrading to 3.6.3
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.2. In order to upgrade to 3.6.3 you need to upgrade to 3.6.2 first.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.6.2
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.2. In order to upgrade to 3.6.3 you need to upgrade to 3.6.2 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.6.3.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.6.2
Start the service
1
net start thingsboard
Upgrading to 3.6.2
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.1. In order to upgrade to 3.6.2 you need to upgrade to 3.6.1 first.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.6.1
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6.1. In order to upgrade to 3.6.2 you need to upgrade to 3.6.1 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.6.2.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.6.1
Start the service
1
net start thingsboard
Upgrading to 3.6.1
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6. In order to upgrade to 3.6.1 you need to upgrade to 3.6 first.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.6.0
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.6. In order to upgrade to 3.6.1 you need to upgrade to 3.6 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.6.1.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.6.0
Start the service
1
net start thingsboard
Upgrading to 3.6
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.5.1. In order to upgrade to 3.6 you need to upgrade to 3.5.1 first.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.5.1
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.5.1. In order to upgrade to 3.6 you need to upgrade to 3.5.1 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.6.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.5.1
Start the service
1
net start thingsboard
Upgrading to 3.5.1
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.5. In order to upgrade to 3.5.1 you need to upgrade to 3.5 first.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.5.0
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.5. In order to upgrade to 3.5.1 you need to upgrade to 3.5 first.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.5.1.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.5.0
Start the service
1
net start thingsboard
Upgrading to 3.5
Ubuntu/CentOS
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.4.4. In order to upgrade to 3.5 you need to upgrade to 3.4.4 first.
Important note before upgrading to ThingsBoard 3.5
ThingsBoard UI was migrated to Angular 15. You need to re-build your custom widgets and rule nodes (which use UI) on Angular 15.
We suggest consulting this guide.
ThingsBoard package download
|
|
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
NOTE:
Package installer may ask you to merge your thingsboard configuration. It is preferred to use merge option to make sure that all your previous parameters will not be overwritten.
Execute regular upgrade script:
1
sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=3.4.4
Start the service
1
sudo service thingsboard start
Windows
NOTE:
These upgrade steps are applicable for ThingsBoard version 3.4.4. In order to upgrade to 3.5 you need to upgrade to 3.4.4 first.
Important note before upgrading to ThingsBoard 3.5
ThingsBoard UI was migrated to Angular 15. You need to re-build your custom widgets and rule nodes (which use UI) on Angular 15.
We suggest consulting this guide.
ThingsBoard package download
Download ThingsBoard installation archive for Windows: thingsboard-windows-3.5.zip.
ThingsBoard service upgrade
- Stop ThingsBoard service if it is running.
1
net stop thingsboard
- Make a backup of previous ThingsBoard configuration located in <ThingsBoard install dir>\conf (for ex. C:\thingsboard\conf).
- Remove ThingsBoard install dir.
- Unzip installation archive to ThingsBoard install dir.
- Compare and merge your old ThingsBoard configuration files (from the backup you made in the first step) with new ones.
- Finally, run upgrade.bat script to upgrade ThingsBoard to the new version.
NOTE:
Scripts listed above should be executed using Administrator Role.
Execute regular upgrade script:
1
C:\thingsboard>upgrade.bat --fromVersion=3.4.4
Start the service
1
net start thingsboard
Next steps
-
Getting started guides - These guides provide quick overview of main ThingsBoard features. Designed to be completed in 15-30 minutes.
-
Connect your device - Learn how to connect devices based on your connectivity technology or solution.
-
Data visualization - These guides contain instructions on how to configure complex ThingsBoard dashboards.
-
Data processing & actions - Learn how to use ThingsBoard Rule Engine.
-
IoT Data analytics - Learn how to use rule engine to perform basic analytics tasks.
-
Hardware samples - Learn how to connect various hardware platforms to ThingsBoard.
-
Advanced features - Learn about advanced ThingsBoard features.
-
Contribution and Development - Learn about contribution and development in ThingsBoard.