Upgrading from Community Edition

wget https://dist.thingsboard.io/thingsboard-4.3.1.2pe.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.2pe.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.2pe.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.2pe.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-4.3.1.2pe.zip.

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.2PE
docker pull thingsboard/tb-pe-web-report:4.3.1.2PE

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.2PE
docker pull thingsboard/tb-pe-web-report:4.3.1.2PE

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

For AWS EKS, Azure AKS, or GCP GKE refer to the corresponding PE installation guides.

./k8s-delete-resources.sh

PE uses a separate repository with additional components. Clone the PE scripts into a separate directory:

git clone -b release-4.3.1.2 https://github.com/thingsboard/thingsboard-pe-k8s.git --depth 1
cd thingsboard-pe-k8s/minikube

Copy your custom settings from the CE configuration (database type, hosts, environment variables, volumes) into the corresponding PE files.

In tb-node.yml, find - name: TB_LICENSE_SECRET and set its value: to your license secret:

- name: TB_LICENSE_SECRET
  value: "YOUR_LICENSE_SECRET"

See How to get a pay-as-you-go subscription or How to get a perpetual license for more details.

./k8s-upgrade-tb.sh --fromVersion=CE

./k8s-deploy-resources.sh

Wait until all pods are running:

kubectl get pods -n thingsboard