On this page
ThingsBoard PE v3.3.x upgrade instructions for Docker
Upgrading ThingsBoard PE to 3.3.4.1
NOTE: These upgrade steps are applicable for ThingsBoard version 3.3.4PE. In order to upgrade to 3.3.4.1PE you need to upgrade to 3.3.4PE first .
ThingsBoard PE image download
Download ThingsBoard PE Docker image:
1
docker pull thingsboard/tb-pe:3.3.4.1PE
ThingsBoard PE service upgrade
Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose stop mytbpe
Update docker-compose.yml
1
2
3
4
< . . . >
mytbpe :
image : " thingsboard/tb-pe:3.3.4.1PE"
< . . . >
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose up -d
Upgrading ThingsBoard PE to 3.3.4
NOTE: These upgrade steps are applicable for ThingsBoard version 3.3.3PE. In order to upgrade to 3.3.4PE you need to upgrade to 3.3.3PE first .
ThingsBoard PE image download
Download ThingsBoard PE Docker image:
1
docker pull thingsboard/tb-pe:3.3.4PE
ThingsBoard PE service upgrade
Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose stop mytbpe
Update docker-compose.yml
1
2
3
4
< . . . >
mytbpe :
image : " thingsboard/tb-pe:3.3.4PE"
< . . . >
Change upgradeversion variable:
1
echo '3.3.3' | sudo tee ~/.mytbpe-data/.upgradeversion
Execute the following commands to upgrade ThingsBoard to the new version:
1
docker compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose up -d
Upgrading ThingsBoard PE to 3.3.3
NOTE : These upgrade steps are applicable for ThingsBoard version 3.3.2PE. In order to upgrade to 3.3.3PE you need to upgrade to 3.3.2PE first .
Important note before upgrading to ThingsBoard 3.3.3
ThingsBoard UI was migrated to Angular 12. You need to re-build your custom widgets and rule nodes (which use UI) on Angular 12.
ThingsBoard PE image download
Download ThingsBoard PE Docker image:
1
docker pull thingsboard/tb-pe:3.3.3PE
ThingsBoard PE service upgrade
Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose stop mytbpe
Update docker-compose.yml
1
2
3
4
< . . . >
mytbpe :
image : " thingsboard/tb-pe:3.3.3PE"
< . . . >
Change upgradeversion variable:
1
echo '3.3.2' | sudo tee ~/.mytbpe-data/.upgradeversion
Execute the following commands to upgrade ThingsBoard to the new version:
1
docker compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose up -d
Upgrading ThingsBoard PE to 3.3.2
NOTE : These upgrade steps are applicable for ThingsBoard version 3.3.1PE. In order to upgrade to 3.3.2PE you need to upgrade to 3.3.1PE first .
ThingsBoard PE image download
Download ThingsBoard PE Docker image:
1
docker pull thingsboard/tb-pe:3.3.2PE
ThingsBoard PE service upgrade
Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose stop mytbpe
Update docker-compose.yml
1
2
3
4
< . . . >
mytbpe :
image : " thingsboard/tb-pe:3.3.2PE"
< . . . >
Change upgradeversion variable:
1
echo '3.3.1' | sudo tee ~/.mytbpe-data/.upgradeversion
Execute the following commands to upgrade ThingsBoard to the new version:
1
docker compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose up -d
Upgrading ThingsBoard PE to 3.3.1
NOTE : These upgrade steps are applicable for ThingsBoard version 3.3.0PE. In order to upgrade to 3.3.1PE you need to upgrade to 3.3.0PE first .
ThingsBoard PE image download
Download ThingsBoard PE Docker image:
1
docker pull thingsboard/tb-pe:3.3.1PE
ThingsBoard PE service upgrade
Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose stop mytbpe
Update docker-compose.yml
1
2
3
4
< . . . >
mytbpe :
image : " thingsboard/tb-pe:3.3.1PE"
< . . . >
Change upgradeversion variable:
1
echo '3.3.0' | sudo tee ~/.mytbpe-data/.upgradeversion
Execute the following commands to upgrade ThingsBoard to the new version:
1
docker compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose up -d
Upgrading ThingsBoard PE to 3.3
NOTE : These upgrade steps are applicable for ThingsBoard version 3.2.2PE. In order to upgrade to 3.3PE you need to upgrade to 3.2.2PE first .
ThingsBoard PE image download
Download ThingsBoard PE Docker image:
1
docker pull thingsboard/tb-pe:3.3.0PE
ThingsBoard PE service upgrade
Stop ThingsBoard mytbpe container if it is running.
1
docker compose stop mytbpe
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose stop mytbpe
Update docker-compose.yml
1
2
3
4
< . . . >
mytbpe :
image : " thingsboard/tb-pe:3.3.0PE"
< . . . >
Change upgradeversion variable:
1
echo '3.2.2' | sudo tee ~/.mytbpe-data/.upgradeversion
Execute the following commands to upgrade ThingsBoard to the new version:
1
docker compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose run mytbpe upgrade-tb.sh
If you still rely on Docker Compose as docker-compose (with a hyphen) execute next command: docker-compose up -d
© 2025 The ThingsBoard Authors