On this page
ThingsBoard Edge PE v3.3.x upgrade instructions for Ubuntu
Backup before upgrading
Make sure your system has enough free space to store the backup.
Stop the ThingsBoard Edge service to prevent data writes during the upgrade:
1
sudo systemctl stop tb-edge
Create the backup:
1
sudo -Hiu postgres pg_dump tb_edge > tb_edge.sql.bak
Verify the backup was created successfully:
Restore the backup (if needed)
Stop the ThingsBoard Edge service (if itβs still running):
1
sudo systemctl stop tb-edge
To restore the PostgreSQL database from a backup file, run the following command:
1
sudo -u postgres psql tb_edge < tb_edge.sql.bak
Start the ThingsBoard Edge service:
1
sudo systemctl start tb-edge
Upgrading Edge CE to 3.3.4.1
Ensure your ThingsBoard Server is up to date before updating ThingsBoard Edge.
If your Server version is outdated, upgrade it first .
The following instructions are applicable for ThingsBoard Edge 3.3.4 version.
Download the Edge package
1
wget https://dist.thingsboard.io/tb-edge-3.3.4.1pe.deb
Stop the ThingsBoard Edge service before upgrading to prevent file conflicts:
1
sudo service tb-edge stop
Upgrade the package
1
sudo dpkg -i tb-edge-3.3.4.1pe.deb
Note: The package installer may prompt you to merge configuration files. Select the merge option to preserve your existing settings.
Execute the upgrade script to migrate your data and configurations:
1
sudo /usr/share/tb-edge/bin/install/upgrade.sh --fromVersion = 3.3.4
Start the Edge service
1
sudo service tb-edge start
© 2026 The ThingsBoard Authors