sendnrw/netbird-docs
2
0
Fork 0
mirror of https://github.com/netbirdio/docs.git synced 2026-10-17 02:59:04 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: correct Go toolchain and OS cutoffs in the client support matrix (#1032)

Browse Source
This commit is contained in:
Bruno Mercier Costa
2026-10-12 14:42:24 +02:00
committed by GitHub
parent 2a748bb210
commit 6804d6b194
5 changed files with 21 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files
src/pages/help/support-matrix/index.mdx
+3 -3
View File
@@ -42,8 +42,8 @@ Each sub-page is maintained alongside its component and updated when support win
## How to read these tables
- **Supported** — covered by bug fixes and security updates.
- **Best-effort** — known to work; issues triaged but not prioritized.
- **Unsupported** — outside the support window; upgrade recommended.
- **Supported**: covered by bug fixes and security updates.
- **Best-effort**: known to work; issues triaged but not prioritized.
- **Unsupported**: outside the support window; upgrade recommended.
If you need help confirming compatibility for a version not listed, see [Report bugs and issues](/help/report-bug-issues).
src/pages/help/support-matrix/netbird-client/index.mdx
+7 -6
View File
@@ -55,15 +55,16 @@ The NetBird client runs across desktop, mobile, and TV platforms. Pick an OS fam
## Go toolchain
The client is built with the Go versions listed below. Building from source against an unsupported Go release is not guaranteed to succeed. Each Go version sets a floor on OS support for that NetBird release — see the per-OS pages above for the resulting cutoffs.
The client is built with the Go versions listed below. Building from source against an unsupported Go release is not guaranteed to succeed. Each Go version sets a floor on OS support for that NetBird release. See the per-OS pages above for the resulting cutoffs.
| NetBird client version | Go version |
|---|---|
| v0.20.0 – v0.25.3 | 1.20 |
| v0.25.4 – v0.29.1 | 1.21 |
| v0.29.2 – v0.60.2 | 1.23 |
| v0.60.3 – v0.62.3 | 1.24 |
| v0.63.0 – current | 1.25 |
| v0.20.0 to v0.25.3 | 1.20 |
| v0.25.4 to v0.29.1 | 1.21 |
| v0.29.2 to v0.60.2 | 1.23 |
| v0.60.3 to v0.62.1 | 1.24 |
| v0.62.2 to v0.77.1 | 1.25 |
| v0.78.0 to current | 1.26 |
## Reporting compatibility issues
src/pages/help/support-matrix/netbird-client/linux.mdx
+4 -4
View File
@@ -10,7 +10,7 @@ NetBird's Linux support depends on the client mode you run:
- **Userspace mode** is supported wherever the Go toolchain is supported. The kernel floor for each NetBird release follows Go's minimum OS requirements (see the table below).
- **Kernel mode** depends on the iptables / nftables features available on the host distribution.
The NetBird team's end-to-end tests cover the distributions below — **Ubuntu 20.04** is the oldest tested release:
The NetBird team's end-to-end tests cover the distributions below. **Ubuntu 20.04** is the oldest tested release:
- Ubuntu 20.04, 22.04, 24.04
- Debian 12
@@ -20,7 +20,7 @@ The NetBird team's end-to-end tests cover the distributions below — **Ubuntu 2
Other distributions are not actively tested; their compatibility follows the mode-specific rules above.
<Warning>
The kernel range below is derived from Go's [minimum OS requirements](https://go.dev/wiki/MinimumRequirements) per NetBird release's Go version, and applies to userspace mode. Kernel mode may have stricter requirements depending on the distribution — confirm with the team for production deployments.
The kernel range below is derived from Go's [minimum OS requirements](https://go.dev/wiki/MinimumRequirements) per NetBird release's Go version, and applies to userspace mode. Kernel mode may have stricter requirements depending on the distribution, so confirm with the team for production deployments.
</Warning>
## Linux kernel (userspace mode)
@@ -28,9 +28,9 @@ Other distributions are not actively tested; their compatibility follows the mod
| Kernel range | NetBird release range |
|---|---|
| 3.2 and newer | v0.60.3 onwards (Go 1.24+) |
| 2.6.32 – 3.1 | ≤ v0.60.2 (Go ≤1.23) |
| 2.6.32 to 3.1 | ≤ v0.60.2 (Go ≤1.23) |
The 2.6.32 floor primarily affected RHEL 6, CentOS 6, Ubuntu 14.04, and Debian 8 — all upstream EOL.
The 2.6.32 floor primarily affected RHEL 6, CentOS 6, Ubuntu 14.04, and Debian 8, all of which are upstream EOL.
## Reporting compatibility issues
src/pages/help/support-matrix/netbird-client/macos.mdx
+3 -2
View File
@@ -8,7 +8,7 @@ export const description =
The NetBird client supports the macOS versions listed below. The floor moves whenever NetBird upgrades its Go toolchain and Go drops an older macOS release.
<Warning>
The version cutoffs below are derived from the [Go toolchain's minimum OS requirements](https://go.dev/wiki/MinimumRequirements) for each NetBird release's Go version. NetBird may have stricter requirements than Go — confirm with the team before relying on them.
The version cutoffs below are derived from the [Go toolchain's minimum OS requirements](https://go.dev/wiki/MinimumRequirements) for each NetBird release's Go version. NetBird may have stricter requirements than Go, so confirm with the team before relying on them.
</Warning>
## macOS versions
@@ -16,8 +16,9 @@ The NetBird client supports the macOS versions listed below. The floor moves whe
| Version | Architectures | Version Supported |
|---|---|---|
| macOS 12 Monterey and newer | x86_64, arm64 | NetBird latest |
| macOS 11 Big Sur | x86_64, arm64 | ≤ v0.62.3 |
| macOS 11 Big Sur | x86_64, arm64 | ≤ v0.62.1 |
| macOS 10.15 Catalina | x86_64 | ≤ v0.29.1 |
| macOS 10.13 High Sierra, 10.14 Mojave | x86_64 | ≤ v0.25.3 |
## Reporting compatibility issues
src/pages/help/support-matrix/netbird-client/windows.mdx
+4 -4
View File
@@ -5,18 +5,18 @@ export const description =
# Windows
Windows 10 and 11 run on the latest NetBird client. Windows 7 and 8 are frozen at NetBird **v0.25.3** — the last release built with Go 1.20, the last Go toolchain to target those Windows versions. Older Windows releases may continue to work on pinned client versions but are not covered by bug fixes or security updates.
Windows 10 and 11 run on the latest NetBird client. Windows 7 and 8 are frozen at NetBird **v0.25.3**, the last release built with Go 1.20, the last Go toolchain to target those Windows versions. Older Windows releases may continue to work on pinned client versions but are not covered by bug fixes or security updates.
<Warning>
The version cutoffs below are derived from the [Go toolchain's minimum OS requirements](https://go.dev/wiki/MinimumRequirements) for each NetBird release's Go version. NetBird may have stricter requirements than Go — confirm with the team before relying on them.
The version cutoffs below are derived from the [Go toolchain's minimum OS requirements](https://go.dev/wiki/MinimumRequirements) for each NetBird release's Go version. NetBird may have stricter requirements than Go, so confirm with the team before relying on them.
</Warning>
## Windows versions
| Version | Architectures | Version Supported |
|---|---|---|
| Windows 11 | x86_64, arm64 | NetBird latest |
| Windows 10 / Server 2016 and newer | x86_64, arm64 | NetBird latest |
| Windows 11 | x86_64, arm64 (since v0.54.0) | NetBird latest |
| Windows 10 / Server 2016 and newer | x86_64, arm64 (since v0.54.0) | NetBird latest |
| Windows 8 / Server 2012 / 2012 R2 | all | ≤ v0.25.3 |
| Windows 7 / Server 2008 R2 | all | ≤ v0.25.3 |