From 89b6f8c54e7c461d4182c4b8f8312f66bbd3f3be Mon Sep 17 00:00:00 2001 From: rmorillo24 Date: Fri, 13 Dec 2024 09:35:11 +0100 Subject: [PATCH] patch: update balenaOS support policy --- pages/faq/questions.md | 2 +- pages/reference/OS/updates/self-service.md | 32 ++++++++++++++++++++-- 2 files changed, 31 insertions(+), 3 deletions(-) diff --git a/pages/faq/questions.md b/pages/faq/questions.md index 64e79d2785..eee8e72d01 100644 --- a/pages/faq/questions.md +++ b/pages/faq/questions.md @@ -128,7 +128,7 @@ Generally, we try to follow good OPSEC practices for our systems. We support 2FA ##### How long is a balenaOS release maintained for? -BalenaOS comes in two flavors, a rolling release and an [Extended Support Release (ESR)](https://www.balena.io/docs/reference/OS/extended-support-release/). Rolling releases stop being maintained as soon as a new release is out. In other words, only the latest balenaOS release is maintained. ESR releases receive bug and security fixes for 9 months after its release date. +BalenaOS comes in two flavors, a rolling release and an [Extended Support Release (ESR)](https://www.balena.io/docs/reference/OS/extended-support-release/). Rolling releases stop being maintained as soon as a new release is out. In other words, only the latest balenaOS release is maintained. ESR releases receive bug and security fixes for 9 months after its release date. More information about our support policy in the [Self-service updates](https://docs.balena.io/reference/OS/updates/self-service/) page. ##### When are device types discontinued? diff --git a/pages/reference/OS/updates/self-service.md b/pages/reference/OS/updates/self-service.md index c4c7c4edaf..4aa40209a6 100644 --- a/pages/reference/OS/updates/self-service.md +++ b/pages/reference/OS/updates/self-service.md @@ -7,14 +7,18 @@ excerpt: How to update {{ $names.os.lower }} versions from your dashboard ## Which devices and versions are supported? -Since we periodically release updates and improvements to {{ $names.os.lower }} (the host OS running on all {{ $names.company.lower }} devices), we encourage you to keep your devices up to date. We offer self-service host OS updates between 2.x versions and from 1.x to 2.x versions. All 2.x devices will default to delta-based updates if available, thus reducing the size of the update sent over the network. +We periodically release updates and improvements to balenaOS, the host operating system that powers all balena devices. These releases are accessible through multiple channels, including the dashboard, SDK, and CLI. -__Note:__ {{ $names.os.upper }} 1.x to 2.x updates limit the amount of data you can have in your application's `/data` folder to about 170MB (compressed). If you have more data, the update will fail and your device won't be modified. +Updating from one version to a newer one is generally supported; however, big version jumps may not always be guaranteed. Devices running balenaOS 2.x and above benefit from delta-based updates when available, significantly reducing the size of updates sent over the network. Self-service updates are available for both `production` and `development` {{ $names.os.lower }} variants. For device types and {{ $names.os.lower }} versions that are not yet supported, please contact us on the [forums][forums]. We are continuously expanding the range of versions and types that can be updated. +Find more information below about our version support policy. + +__Note:__ {{ $names.os.upper }} 1.x to 2.x updates limit the amount of data you can have in your application's `/data` folder to about 170MB (compressed). If you have more data, the update will fail and your device won't be modified. + ## Running an update To run an update for an individual device, navigate to that device's *Settings* tab, go to the section *OS version*, and select the version of {{ $names.os.lower }} you would like to update to. After making your selection, click the *Save* button. @@ -43,6 +47,30 @@ If your {{ $names.os.lower }} update fails for any reason, the device should sti Check out our [update process][update-process] to understand how the process goes through each step. +## balenaOS support policy + +We have two release strategies, that you can use depending on your needs and subscription plan. This is our maintenance and support policy: + +### Rolling Releases + +- We only maintain the latest rolling release of balenaOS. +- When a new release is published, the previous version is no longer maintained. +- If you’re not on the latest version and need help, we recommend updating to the most recent release for compatibility and support. +- You can report issues on the latest rolling release; bug fixes, if any, will only be included in future rolling releases. +- We understand it’s not always possible to stay up to date. For this reason, we offer reasonable assistance to help unblock you on your current version. However, any identified bugs will only be resolved in the latest rolling release. + +### Extended Support Releases (ESR) + +- ESR provides stable balenaOS releases supported for 9 months, with quarterly updates to adopt new versions. +- Only high-risk security fixes and critical bug fixes are backported; no new features are added. +- Each ESR version follows a 3-phase lifecycle: + - `Next-ESR` (6-9 months with active fixes). + - `Current-ESR` (3-6 months). + - `Sunset-ESR` (final 3 months). +- After 9 months, the ESR version reaches end-of-life (EOL), with no further updates. + +For more details, visit our [Extended Support Release documentation](https://docs.balena.io/reference/OS/extended-support-release/). + [forums]:{{ $names.forums_domain }}/ [troubleshooting]:{{ $names.forums_domain }}/c/troubleshooting