Stand with Ukraine flag
Pricing Try it now
Community Edition
Community Edition Professional Edition Cloud Edge PE Edge IoT Gateway License Server Trendz Analytics Mobile Application PE Mobile Application MQTT Broker PE MQTT Broker
Getting Started Documentation Guides
Architecture API FAQ
On this page

ThingsBoard CE v4.2.x upgrade instructions for Docker

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 CE service upgrade

  1. Change the version of the thingsboard/tb-node in the docker-compose.yml file to the 4.2.2.

  2. Execute the following commands:

1
2

docker pull thingsboard/tb-node:4.2.2
docker compose stop thingsboard-ce
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

docker compose run --rm -e UPGRADE_TB=true thingsboard-ce 

1

docker compose up -d

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 CE service upgrade

  1. Change the version of the thingsboard/tb-node in the docker-compose.yml file to the 4.2.1.2.

  2. Execute the following commands:

1
2

docker pull thingsboard/tb-node:4.2.1.2
docker compose stop thingsboard-ce
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

docker compose run --rm -e UPGRADE_TB=true thingsboard-ce 

1

docker compose up -d

Upgrading ThingsBoard CE to 4.2

ThingsBoard CE service upgrade

  1. Change the version of the thingsboard/tb-node in the docker-compose.yml file to the 4.2.0.

  2. Execute the following commands:

1
2

docker pull thingsboard/tb-node:4.2.0
docker compose stop thingsboard-ce
doc warn icon

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

1

docker compose run --rm -e UPGRADE_TB=true thingsboard-ce 

1

docker compose up -d