ThingsBoard PE v4.3.x upgrade instructions for Docker Compose

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.

We strongly recommend that you also update your Docker Compose deployment manifests to the corresponding version from GitHub repository with every ThingsBoard upgrade. This ensures your ThingsBoard service runs with the latest best-practice parameters and configurations, while also guarantees that all required services are correctly deployed to support the newest features introduced in the release.

If you are running older releases of ThingsBoard - be aware that the manifests in master branch of the repository may contain configurations for features that are not available in your specific version. Always ensure that manifests are compatible with your target ThingsBoard version while merging deployment files.

Compatibility check before upgrading

If you are using Edge PE or Trendz Analytics together with ThingsBoard, verify that your target ThingsBoard version is compatible with the currently installed versions of these components. Upgrade them if required to ensure compatibility.

• Edge PE: Releases table
• Trendz Analytics: Releases table

If you are upgrading from 4.2.1+, you must run the script below. However, if you are upgrading from version 4.3.0+, DO NOT run the upgrade script; proceed directly to starting the service.

This version has known security vulnerabilities that are fixed in newer releases. We recommend upgrading to the latest patch version instead.

We strongly recommend that you also update your Docker Compose deployment manifests to the corresponding version from GitHub repository with every ThingsBoard upgrade. This ensures your ThingsBoard service runs with the latest best-practice parameters and configurations, while also guarantees that all required services are correctly deployed to support the newest features introduced in the release.

If you are running older releases of ThingsBoard - be aware that the manifests in master branch of the repository may contain configurations for features that are not available in your specific version. Always ensure that manifests are compatible with your target ThingsBoard version while merging deployment files.

Compatibility check before upgrading

If you are using Edge PE or Trendz Analytics together with ThingsBoard, verify that your target ThingsBoard version is compatible with the currently installed versions of these components. Upgrade them if required to ensure compatibility.

• Edge PE: Releases table
• Trendz Analytics: Releases table

If you are upgrading from 4.2.1+, you must run the script below. However, if you are upgrading from version 4.3.0.x, DO NOT run the upgrade script; proceed directly to starting the service.