From e34128f9db9a18b32db2471230008cf1bf33251a Mon Sep 17 00:00:00 2001 From: Christina Ying Wang Date: Mon, 5 Jan 2026 16:33:11 -0800 Subject: [PATCH 1/2] Amend supported SV version for OS/kernel container contracts to 17.4.2 Change-type: patch Signed-off-by: Christina Ying Wang --- pages/learn/develop/multicontainer.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/learn/develop/multicontainer.md b/pages/learn/develop/multicontainer.md index 2d33997916..5f94bd7201 100644 --- a/pages/learn/develop/multicontainer.md +++ b/pages/learn/develop/multicontainer.md @@ -127,8 +127,8 @@ The following set of requirement labels are enforced via the supervisor. Each se | io.{{ $names.company.short }}.features.requires.sw.l4t | [L4T][l4t] version (specified as a [version range][version-range]) | 10.16.17 | | io.{{ $names.company.short }}.features.requires.hw.device-type | The [device type][device-type] as given by `BALENA_MACHINE_NAME` | 11.1.0 | | io.{{ $names.company.short }}.features.requires.arch.sw | The [architecture][arch] as given by `BALENA_ARCH` | 14.10.11 | -| io.{{ $names.company.short }}.features.requires.sw.balena-os | ${{ names.os.lower }} version (specified as a [version range][version-range]) | 17.4.0 | -| io.{{ $names.company.short }}.features.requires.sw.linux | Linux kernel version (specified as a [version range][version-range]) | 17.4.0 | +| io.{{ $names.company.short }}.features.requires.sw.balena-os | ${{ names.os.lower }} version (specified as a [version range][version-range]) | 17.4.2 | +| io.{{ $names.company.short }}.features.requires.sw.linux | Linux kernel version (specified as a [version range][version-range]) | 17.4.2 | For example, the following composition defines requirements on the supervisor and l4t version on the first service, and on the device type and architecture on the second service. From 1583feb04e3e9d9506a37917b92c9b5dc3a82270 Mon Sep 17 00:00:00 2001 From: Christina Ying Wang Date: Mon, 5 Jan 2026 16:34:01 -0800 Subject: [PATCH 2/2] Add CLI version requirement for container contracts Signed-off-by: Christina Ying Wang --- pages/learn/develop/multicontainer.md | 18 ++++++++---------- 1 file changed, 8 insertions(+), 10 deletions(-) diff --git a/pages/learn/develop/multicontainer.md b/pages/learn/develop/multicontainer.md index 5f94bd7201..2123b39157 100644 --- a/pages/learn/develop/multicontainer.md +++ b/pages/learn/develop/multicontainer.md @@ -115,20 +115,18 @@ In addition to the settings above, there are some {{ $names.company.lower }} spe ### Container requirements -**Note:** Container requirements are available when using balenaCLI >= 21.1.0 - An additional set of labels ensures device compatibility for running a service. For example, before updating to a new release, it may be desirable to ensure that the device is running a specific version of [Supervisor][supervisor] or has a specific version of the [NVIDIA Tegra Linux Driver Package][l4t] (L4T). The following set of requirement labels are enforced via the supervisor. Each service may define one or more requirements and if any of them is not met for any non-[optional](#optional-containers) service, then [the release will be rejected][update-statuses] and no changes will be performed for the new release. -| Label | Description | Valid from Supervisor | -| -------------------------------------------------------------- | ----------------------------------------------------------------------------- | --------------------- | -| io.{{ $names.company.short }}.features.requires.sw.supervisor | Device Supervisor version (specified as a [version range][version-range]) | 10.16.17 | -| io.{{ $names.company.short }}.features.requires.sw.l4t | [L4T][l4t] version (specified as a [version range][version-range]) | 10.16.17 | -| io.{{ $names.company.short }}.features.requires.hw.device-type | The [device type][device-type] as given by `BALENA_MACHINE_NAME` | 11.1.0 | -| io.{{ $names.company.short }}.features.requires.arch.sw | The [architecture][arch] as given by `BALENA_ARCH` | 14.10.11 | -| io.{{ $names.company.short }}.features.requires.sw.balena-os | ${{ names.os.lower }} version (specified as a [version range][version-range]) | 17.4.2 | -| io.{{ $names.company.short }}.features.requires.sw.linux | Linux kernel version (specified as a [version range][version-range]) | 17.4.2 | +| Label | Description | Valid from Supervisor | Valid from CLI | +| -------------------------------------------------------------- | ----------------------------------------------------------------------------- | --------------------- | ------ | +| io.{{ $names.company.short }}.features.requires.sw.supervisor | Device Supervisor version (specified as a [version range][version-range]) | 10.16.17 | 21.1.0 | +| io.{{ $names.company.short }}.features.requires.sw.l4t | [L4T][l4t] version (specified as a [version range][version-range]) | 10.16.17 | 21.1.0 | +| io.{{ $names.company.short }}.features.requires.hw.device-type | The [device type][device-type] as given by `BALENA_MACHINE_NAME` | 11.1.0 | 21.1.0 | +| io.{{ $names.company.short }}.features.requires.arch.sw | The [architecture][arch] as given by `BALENA_ARCH` | 14.10.11 | 21.1.0 | +| io.{{ $names.company.short }}.features.requires.sw.balena-os | ${{ names.os.lower }} version (specified as a [version range][version-range]) | 17.4.2 | TODO | +| io.{{ $names.company.short }}.features.requires.sw.linux | Linux kernel version (specified as a [version range][version-range]) | 17.4.2 | TODO | For example, the following composition defines requirements on the supervisor and l4t version on the first service, and on the device type and architecture on the second service.