Stand with Ukraine flag
Pricing Try it now
Community Edition
Getting Started Documentation Guides
Architecture API FAQ
On this page

ThingsBoard CE v4.2.x upgrade instructions for Ubuntu

Upgrading ThingsBoard CE to latest 4.2.x (4.2.2)

Doc info icon

NOTE:

These upgrade steps are applicable for ThingsBoard version 4.2.0+. In order to upgrade to 4.2.2 you need to upgrade to 4.2.0 first.

doc warn icon

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 package download

1
wget https://github.com/thingsboard/thingsboard/releases/download/v4.2.2/thingsboard-4.2.2.deb

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
1
sudo dpkg -i thingsboard-4.2.2.deb
Doc info icon

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.

doc warn icon

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.

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh

Start the service

1
sudo service thingsboard start

Upgrading ThingsBoard CE to 4.2.1.2

Doc info icon

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.2 you need to upgrade to 4.2.0 first.

doc warn icon

This version has known security vulnerabilities that are fixed in newer releases. We recommend upgrading to the latest patch version instead.

ThingsBoard package download

1
wget https://github.com/thingsboard/thingsboard/releases/download/v4.2.1.2/thingsboard-4.2.1.2.deb

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
1
sudo dpkg -i thingsboard-4.2.1.2.deb
Doc info icon

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.

doc warn icon

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.

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh

Start the service

1
sudo service thingsboard start

Upgrading ThingsBoard CE to 4.2

ThingsBoard package download

1
wget https://github.com/thingsboard/thingsboard/releases/download/v4.2/thingsboard-4.2.deb

ThingsBoard service upgrade

  • Stop ThingsBoard service if it is running.
1
sudo service thingsboard stop
1
sudo dpkg -i thingsboard-4.2.deb
Doc info icon

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.

doc warn icon

If you are upgrading from version 4.1, you must run the script below

1
sudo /usr/share/thingsboard/bin/install/upgrade.sh

Start the service

1
sudo service thingsboard start