Skip to content

Commit

Permalink
patch: update balenaOS support policy
Browse files Browse the repository at this point in the history
  • Loading branch information
rmorillo24 committed Dec 13, 2024
1 parent a34017e commit 89b6f8c
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 3 deletions.
2 changes: 1 addition & 1 deletion pages/faq/questions.md
Original file line number Diff line number Diff line change
Expand Up @@ -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?

Expand Down
32 changes: 30 additions & 2 deletions pages/reference/OS/updates/self-service.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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/).

<!-- links -->
[forums]:{{ $names.forums_domain }}/
[troubleshooting]:{{ $names.forums_domain }}/c/troubleshooting
Expand Down

0 comments on commit 89b6f8c

Please sign in to comment.