You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on May 22, 2026. It is now read-only.
Copy file name to clipboardExpand all lines: _includes/docs/releases/release-policy.md
+30-17Lines changed: 30 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,9 +5,11 @@ This guide explains how ThingsBoard versions are numbered, how long each version
5
5
It’s written for platform administrators, SREs, DevOps engineers, and technical users who deploy and maintain ThingsBoard.
6
6
7
7
---
8
-
## Thingsboard versioning
8
+
9
+
## ThingsBoard versioning
10
+
9
11
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.
10
-
Thingsboard version numbers have four parts: <spanclass="code-light">MAJOR.MINOR.MAINTENANCE.PATCH</span>. For example, version <spanclass="code-light">4.2.1.0</span> indicates major version 4, minor version 2, maintenece 1 and patch level 0.
12
+
ThingsBoard version numbers have four parts: <spanclass="code-light">MAJOR.MINOR.MAINTENANCE.PATCH</span>. For example, version <spanclass="code-light">4.2.1.0</span> indicates major version 4, minor version 2, maintenece 1 and patch level 0.
11
13
12
14
The version number is incremented based on the level of change included in the release.
13
15
@@ -54,31 +56,42 @@ The version number is incremented based on the level of change included in the r
54
56
<spanclass="code-light">4.2.1.3</span> — Hotfixes on top of <spanclass="code-light">4.2.1.0</span>; zero‑downtime within <spanclass="code-light">4.2.1.x</span>
55
57
56
58
57
-
## Lifecycle & Support (How long versions are supported)
59
+
## Lifecycle & Support (How long versions are supported?)
58
60
59
61
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.
60
62
61
-
***LTS declaration:** We announce a new **LTS** line each year; each LTS line is supported for **18 months** from initial LTS GA (e.g., from <spanclass="code-light">4.2.0.0</span> release date)
62
-
63
-
Active support includes:
64
-
- Bug fixes, security patches
65
-
- New MAINTENANCE (…x.0) and PATCH (…x.y) releases as needed
66
-
67
-
***Major releases:** When breaking changes are introduced.
68
-
69
-
***Minor releases:** Typically every **three** months.
70
-
71
-
***Maintenance releases:** When bug fixes need an upgrade script.
72
-
73
-
***Patch releases:** When bug fixes don`t need an upgrade script.
<td>Announced yearly; for stable, long-term production use.</td>
76
+
<td><b>18 months</b> from initial LTS GA (e.g., 4.2.0.0 release date)</td>
77
+
<td>Annually</td>
78
+
</tr>
79
+
<tr>
80
+
<td><b>Standard</b></td>
81
+
<td>Releases between LTS lines, including new features.</td>
82
+
<td><b>6 months</b> from initial GA date</td>
83
+
<td>Every three months (Minor)</td>
84
+
</tr>
85
+
</tbody>
86
+
</table>
74
87
75
88
## Choosing the Right Version
76
89
77
90
**If you run production:**
78
91
79
92
1.**Prefer the latest LTS line** in Active Support.
80
93
81
-
2. To stay up to date with hotfixes, track the line’s PATCH updates only (same MAINTENANCE number, e.g., <spanclass="code-light">4.2.1.0</span> → <spanclass="code-light">4.2.1.3</span>).
94
+
2. To stay up to date with hotfixes, track the line’s **PATCH** updates only (same MAINTENANCE number, e.g., <spanclass="code-light">4.2.1.0</span> → <spanclass="code-light">4.2.1.3</span>).
82
95
83
96
3.**Schedule maintenance windows** to adopt new **MAINTENANCE** releases when needed (e.g., <spanclass="code-light">4.2.0.x</span> → <spanclass="code-light">4.2.1.0</span>).
0 commit comments