Upgrade instructions

In order to update ThingsBoard PE please follow these instructions

• Upgrading to 3.6.4
  • Ubuntu/CentOS
  • Windows
• Upgrading to 3.6.3
  • Ubuntu/CentOS
  • Windows
• Upgrading to 3.6.2
  • Ubuntu/CentOS
  • Windows
• Upgrading to 3.6.1
  • Ubuntu/CentOS
  • Windows
• Upgrading to 3.6
  • Ubuntu/CentOS
  • Windows
• Upgrading to 3.5.1
  • Ubuntu/CentOS
  • Windows
• Upgrading to 3.5
  • Ubuntu/CentOS
  • Windows
• Older versions

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

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.4/thingsboard-3.6.4.deb

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.4/thingsboard-3.6.4.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo dpkg -i thingsboard-3.6.4.deb

1
sudo rpm -Uvh thingsboard-3.6.4.rpm

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

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.3/thingsboard-3.6.3.deb

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.3/thingsboard-3.6.3.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo dpkg -i thingsboard-3.6.3.deb

1
sudo rpm -Uvh thingsboard-3.6.3.rpm

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

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.2/thingsboard-3.6.2.deb

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.2/thingsboard-3.6.2.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo dpkg -i thingsboard-3.6.2.deb

1
sudo rpm -Uvh thingsboard-3.6.2.rpm

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

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.1/thingsboard-3.6.1.deb

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6.1/thingsboard-3.6.1.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo dpkg -i thingsboard-3.6.1.deb

1
sudo rpm -Uvh thingsboard-3.6.1.rpm

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

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6/thingsboard-3.6.deb

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.6/thingsboard-3.6.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo dpkg -i thingsboard-3.6.deb

1
sudo rpm -Uvh thingsboard-3.6.rpm

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

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.5.1/thingsboard-3.5.1.deb

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.5.1/thingsboard-3.5.1.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo dpkg -i thingsboard-3.5.1.deb

1
sudo rpm -Uvh thingsboard-3.5.1.rpm

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

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.5/thingsboard-3.5.deb

1
wget https://github.com/thingsboard/thingsboard/releases/download/v3.5/thingsboard-3.5.rpm

ThingsBoard service upgrade

• Stop ThingsBoard service if it is running.

1
sudo service thingsboard stop

1
sudo dpkg -i thingsboard-3.5.deb

1
sudo rpm -Uvh thingsboard-3.5.rpm

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.