diff --git a/_includes/docs/releases/release-policy.md b/_includes/docs/releases/release-policy.md index 7934dcbde2..062127cad0 100644 --- a/_includes/docs/releases/release-policy.md +++ b/_includes/docs/releases/release-policy.md @@ -9,11 +9,11 @@ It’s written for platform administrators, SREs, DevOps engineers, and technica ## ThingsBoard versioning ThingsBoard version numbers reflect the scope of changes introduced in each release. This follows semantic versioning principles, helping you gauge the potential impact of upgrading. -ThingsBoard version numbers have four parts: MAJOR.MINOR.MAINTENANCE.PATCH. For example, version 4.2.1.0 indicates major version 4, minor version 2, maintenece 1 and patch level 0. +ThingsBoard version numbers have four parts: MAJOR.MINOR.MAINTENANCE.PATCH. For example, version 4.2.1.0 indicates major version 4, minor version 2, maintenance 1 and patch level 0. The version number is incremented based on the level of change included in the release. - +
@@ -34,8 +34,8 @@ The version number is incremented based on the level of change included in the r - - + + @@ -55,12 +55,13 @@ The version number is incremented based on the level of change included in the r 4.2.1.3 — Hotfixes on top of 4.2.1.0; zero‑downtime within 4.2.1.x +4.2.2.0 — Maintenance release: includes Angular upgrade (18 → 20). No DB scripts required, but potential UI impact. ## Lifecycle & Support (How long versions are supported?) ThingsBoard maintains **Long‑Term Support (LTS)** lines for production users. Customers using LTS releases can be confident that their critical systems will be protected and operate reliably. -
Level
MAINTENANCEBug fixes/security vulnerabilities/framework upgrades that may require upgrade scriptsYesBug fixes, security fixes, framework upgrades
Note: Upgrade scripts are usually required, but not always (e.g. Angular 18→20)
May be required
PATCH
+
@@ -95,10 +96,15 @@ ThingsBoard maintains **Long‑Term Support (LTS)** lines for production users. 3. **Schedule maintenance windows** to adopt new **MAINTENANCE** releases when needed (e.g., 4.2.0.x4.2.1.0). +4. **Framework upgrades in MAINTENANCE releases** (e.g., Angular 18 → 20): + * We provide **full backward compatibility for the core platform** and **do not require any upgrade scripts**. + * However, **custom UI code** (widgets or custom CSS) that depends on internal component structure or CSS variable names **may break**. + * This can affect **up to 1% of users** with heavy customizations. + * **Recommendation:** Always test custom UI in a staging environment before upgrading to such MAINTENANCE releases. ## Docker Hub Tagging Strategy -
Release Type
+
@@ -118,7 +124,7 @@ ThingsBoard maintains **Long‑Term Support (LTS)** lines for production users. - +
TagM.m.P 4.2.1-latest Automatic safe patches Floating (within 4.2.1.x)Floating (within 4.2.1.x)
latest