Upgrading from Community Edition

wget https://dist.thingsboard.io/thingsboard-4.3.1.1PE.deb

Stop ThingsBoard service if it is running:

sudo service thingsboard stop

Install ThingsBoard Web Report component as described in the Ubuntu installation guide.

sudo dpkg -i thingsboard-4.3.1.1PE.deb

Configure the Professional Edition license key as described in the Ubuntu installation guide.

Execute the upgrade script:

sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=CE

sudo service thingsboard start

wget https://dist.thingsboard.io/thingsboard-4.3.1.1PE.rpm

Stop ThingsBoard service if it is running:

sudo service thingsboard stop

Install ThingsBoard Web Report component as described in the Ubuntu installation guide.

sudo rpm -Uvh thingsboard-4.3.1.1PE.rpm

Configure the Professional Edition license key as described in the Ubuntu installation guide.

Execute the upgrade script:

sudo /usr/share/thingsboard/bin/install/upgrade.sh --fromVersion=CE

sudo service thingsboard start

Download ThingsBoard PE installation package for Windows: thingsboard-windows-setup-4.3.1.1PE.exe.

Stop ThingsBoard service if it is running:

net stop thingsboard

• Make a backup of previous ThingsBoard CE configuration located in <ThingsBoard install dir>\conf (e.g. C:\thingsboard\conf).
• Run the installer executable.
• Compare and merge your old ThingsBoard configuration files (from the backup) with the new ones.
• Configure the Professional Edition license key as described in the Windows installation guide.

Execute the upgrade script:

C:\thingsboard>upgrade.bat --fromVersion=CE

net start thingsboard

docker pull thingsboard/tb-pe-node:4.3.1.1PE
docker pull thingsboard/tb-pe-web-report:4.3.1.1PE

Stop and remove the ThingsBoard CE service:

docker compose stop thingsboard-ce
docker compose rm -f thingsboard-ce

Update your docker-compose.yml according to the Docker PE installation guide. Make sure to change the image to the PE version, define the required license variables and volumes, and add the Web Report service.

Run the upgrade and start the services:

docker compose run --rm -e UPGRADE_TB=true -e FROM_VERSION="CE" thingsboard-pe
docker compose up -d

docker pull thingsboard/tb-pe-node:4.3.1.1PE
docker pull thingsboard/tb-pe-web-report:4.3.1.1PE

Stop the CE services:

./docker-stop-services.sh

Manually merge your current ThingsBoard CE cluster configuration with the default Docker Compose cluster deployment files. Ensure that you transfer all custom environment variables, volume mappings, and external service configurations to the new files.

Configure the license key environment variables as described in the PE Docker Compose Cluster Setup Guide.

Run the upgrade and start the services:

./docker-upgrade-tb.sh --fromVersion=CE
./docker-start-services.sh