diff --git a/src/components/NavigationDocs.jsx b/src/components/NavigationDocs.jsx index 709852c6a..e9ff19bd6 100644 --- a/src/components/NavigationDocs.jsx +++ b/src/components/NavigationDocs.jsx @@ -809,6 +809,60 @@ export const docsNavigation = [ href: '/help/troubleshooting-client', }, { title: 'Report bugs and issues', href: '/help/report-bug-issues' }, + { + title: 'Support Matrix', + isOpen: false, + links: [ + { title: 'Overview', href: '/help/support-matrix' }, + { + title: 'NetBird Client', + href: '/help/support-matrix/netbird-client', + isOpen: false, + links: [ + { + title: 'Linux', + href: '/help/support-matrix/netbird-client/linux', + }, + { + title: 'Windows', + href: '/help/support-matrix/netbird-client/windows', + }, + { + title: 'macOS', + href: '/help/support-matrix/netbird-client/macos', + }, + { + title: 'iOS', + href: '/help/support-matrix/netbird-client/ios', + }, + { + title: 'Android', + href: '/help/support-matrix/netbird-client/android', + }, + { + title: 'Android TV', + href: '/help/support-matrix/netbird-client/android-tv', + }, + { + title: 'tvOS', + href: '/help/support-matrix/netbird-client/tvos', + }, + ], + }, + { + title: 'Kubernetes Operator', + href: '/help/support-matrix/kubernetes-operator', + }, + { + title: 'Terraform Provider', + href: '/help/support-matrix/terraform-provider', + }, + { + title: 'Self-Hosted', + href: '/help/support-matrix/self-hosted', + }, + ], + }, ], }, ] diff --git a/src/pages/help/support-matrix/index.mdx b/src/pages/help/support-matrix/index.mdx new file mode 100644 index 000000000..307662e86 --- /dev/null +++ b/src/pages/help/support-matrix/index.mdx @@ -0,0 +1,49 @@ +import { Warning } from '@/components/mdx' +import { Tiles } from '@/components/Tiles' + +export const description = + 'Supported versions for NetBird client, integrations, and tooling.' + +# Support Matrix + +This page lists the versions of operating systems, runtimes, and platforms officially supported across NetBird's client, integrations, and tooling. Use it to confirm compatibility before deploying or upgrading. + +Each sub-page is maintained alongside its component and updated when support windows change. + + + This support matrix is a work in progress. Entries may change as we finalize support windows with the team. + + + + +## 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. + +If you need help confirming compatibility for a version not listed, see [Report bugs and issues](/help/report-bug-issues). diff --git a/src/pages/help/support-matrix/kubernetes-operator.mdx b/src/pages/help/support-matrix/kubernetes-operator.mdx new file mode 100644 index 000000000..05caa988b --- /dev/null +++ b/src/pages/help/support-matrix/kubernetes-operator.mdx @@ -0,0 +1,18 @@ +export const description = + 'Kubernetes and NetBird control-plane versions supported by the NetBird Kubernetes operator.' + +# Kubernetes Operator Support Matrix + +## Kubernetes compatibility + +The NetBird Kubernetes operator targets the Kubernetes minor versions that are currently receiving patch releases from upstream. The [Kubernetes release policy](https://kubernetes.io/releases/) keeps release branches active for the three most recent minor versions, with roughly one year of patch support each — the operator tracks that same window. + +In practice this means the operator avoids depending on Kubernetes APIs or features that are not yet available across every supported minor version. When upstream drops a minor version from patch support, the operator may begin adopting capabilities that became generally available during that version's lifetime. + +## NetBird control-plane compatibility + +The operator is developed against the latest NetBird control-plane release. Older control-plane versions may continue to work, but compatibility is not actively verified outside the current release. + +## Reporting compatibility issues + +If you hit a problem on a supported combination, see [Report bugs and issues](/help/report-bug-issues). Include your operator version, Kubernetes version (`kubectl version`), and NetBird control-plane version. diff --git a/src/pages/help/support-matrix/netbird-client/android-tv.mdx b/src/pages/help/support-matrix/netbird-client/android-tv.mdx new file mode 100644 index 000000000..bfe20111f --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/android-tv.mdx @@ -0,0 +1,23 @@ +import { Note } from '@/components/mdx' + +export const description = + 'Supported Android TV versions for the NetBird client.' + +# Android TV + +The NetBird client supports the Android TV versions listed below. + + + Entries marked **TBD** will be filled in once the support windows are confirmed with the team. + + +## Android TV versions + +| Version (API level) | Architectures | Version Supported | +|---|---|---| +| TBD | TBD | TBD | +| TBD | TBD | TBD | + +## Reporting compatibility issues + +See [Report bugs and issues](/help/report-bug-issues). Include your Android TV version, device model, and NetBird client version. diff --git a/src/pages/help/support-matrix/netbird-client/android.mdx b/src/pages/help/support-matrix/netbird-client/android.mdx new file mode 100644 index 000000000..7672ef34a --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/android.mdx @@ -0,0 +1,23 @@ +import { Note } from '@/components/mdx' + +export const description = + 'Supported Android versions and architectures for the NetBird client.' + +# Android + +The NetBird client supports the Android versions listed below. + + + Entries marked **TBD** will be filled in once the support windows are confirmed with the team. + + +## Android versions + +| Version (API level) | Architectures | Version Supported | +|---|---|---| +| TBD | TBD | TBD | +| TBD | TBD | TBD | + +## Reporting compatibility issues + +See [Report bugs and issues](/help/report-bug-issues). Include your Android version, device model, and NetBird client version. diff --git a/src/pages/help/support-matrix/netbird-client/index.mdx b/src/pages/help/support-matrix/netbird-client/index.mdx new file mode 100644 index 000000000..dc87927b1 --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/index.mdx @@ -0,0 +1,70 @@ +import { Note } from '@/components/mdx' +import { Tiles } from '@/components/Tiles' + +export const description = + 'Operating systems and Go toolchain versions supported by the NetBird client.' + +# NetBird Client Support Matrix + +The NetBird client runs across desktop, mobile, and TV platforms. Pick an OS family below for its distributions, versions, and architectures. + + + Until this matrix is complete, also check the latest [Go-compatible platforms](https://go.dev/wiki/#platform-specific-information) alongside NetBird's own guidance. + + + + +## 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. + +| 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 | + +## Reporting compatibility issues + +If you hit a problem on a supported platform, see [Report bugs and issues](/help/report-bug-issues). Include your client version (`netbird version`) and OS details. diff --git a/src/pages/help/support-matrix/netbird-client/ios.mdx b/src/pages/help/support-matrix/netbird-client/ios.mdx new file mode 100644 index 000000000..797aaeed2 --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/ios.mdx @@ -0,0 +1,23 @@ +import { Note } from '@/components/mdx' + +export const description = + 'Supported iOS versions for the NetBird client.' + +# iOS + +The NetBird client supports the iOS versions listed below. + + + Entries marked **TBD** will be filled in once the support windows are confirmed with the team. + + +## iOS versions + +| Version | Devices | Version Supported | +|---|---|---| +| TBD | TBD | TBD | +| TBD | TBD | TBD | + +## Reporting compatibility issues + +See [Report bugs and issues](/help/report-bug-issues). Include your iOS version, device model, and NetBird client version. diff --git a/src/pages/help/support-matrix/netbird-client/linux.mdx b/src/pages/help/support-matrix/netbird-client/linux.mdx new file mode 100644 index 000000000..19131a20c --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/linux.mdx @@ -0,0 +1,41 @@ +import { Note, Warning } from '@/components/mdx' + +export const description = + 'Supported Linux distributions, kernel versions, and architectures for the NetBird client.' + +# Linux + +The NetBird client runs on most modern Linux distributions. The kernel floor is set by the Go toolchain each NetBird release is built against; distribution coverage is determined by what the NetBird team builds and tests. + + + The kernel cutoffs below are derived from the [Go toolchain's minimum OS requirements](https://go.dev/wiki/MinimumRequirements) for each NetBird release's Go version. Distribution-specific support beyond the kernel floor is determined by the NetBird team's testing — confirm before relying on it. + + +## Linux kernel + +| 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) | + +Most distributions released since ~2012 ship a 3.2+ kernel and run the latest NetBird client. The 2.6.32 floor primarily affected RHEL 6, CentOS 6, Ubuntu 14.04, and Debian 8, all of which are upstream EOL. + + + Distribution entries marked **TBD** will be filled in once coverage is confirmed with the team. + + +## Distributions + +| Distro | Minimum release | Architectures | Notes | +|---|---|---|---| +| Ubuntu | TBD | TBD | TBD | +| Debian | TBD | TBD | TBD | +| Fedora | TBD | TBD | TBD | +| RHEL / Alma / Rocky | TBD | TBD | TBD | +| openSUSE | TBD | TBD | TBD | +| Alpine | TBD | TBD | TBD | +| Arch | rolling | TBD | TBD | + +## Reporting compatibility issues + +See [Report bugs and issues](/help/report-bug-issues). Include your distro, kernel version (`uname -r`), and NetBird client version (`netbird version`). diff --git a/src/pages/help/support-matrix/netbird-client/macos.mdx b/src/pages/help/support-matrix/netbird-client/macos.mdx new file mode 100644 index 000000000..8c55e6ec8 --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/macos.mdx @@ -0,0 +1,24 @@ +import { Warning } from '@/components/mdx' + +export const description = + 'Supported macOS versions and architectures for the NetBird client.' + +# macOS + +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. + + + 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. + + +## macOS versions + +| 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 10.15 Catalina | x86_64 | ≤ v0.29.1 | + +## Reporting compatibility issues + +See [Report bugs and issues](/help/report-bug-issues). Include your macOS version, hardware architecture, and NetBird client version (`netbird version`). diff --git a/src/pages/help/support-matrix/netbird-client/tvos.mdx b/src/pages/help/support-matrix/netbird-client/tvos.mdx new file mode 100644 index 000000000..b99a79def --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/tvos.mdx @@ -0,0 +1,23 @@ +import { Note } from '@/components/mdx' + +export const description = + 'Supported tvOS versions for the NetBird client.' + +# tvOS + +The NetBird client supports the tvOS versions listed below. + + + Entries marked **TBD** will be filled in once the support windows are confirmed with the team. + + +## tvOS versions + +| Version | Devices | Version Supported | +|---|---|---| +| TBD | TBD | TBD | +| TBD | TBD | TBD | + +## Reporting compatibility issues + +See [Report bugs and issues](/help/report-bug-issues). Include your tvOS version, device model, and NetBird client version. diff --git a/src/pages/help/support-matrix/netbird-client/windows.mdx b/src/pages/help/support-matrix/netbird-client/windows.mdx new file mode 100644 index 000000000..9cda7a4dc --- /dev/null +++ b/src/pages/help/support-matrix/netbird-client/windows.mdx @@ -0,0 +1,25 @@ +import { Warning } from '@/components/mdx' + +export const description = + 'Supported Windows versions and architectures for the NetBird client.' + +# 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. + + + 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. + + +## 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 8 / Server 2012 / 2012 R2 | all | ≤ v0.25.3 | +| Windows 7 / Server 2008 R2 | all | ≤ v0.25.3 | + +## Reporting compatibility issues + +See [Report bugs and issues](/help/report-bug-issues). Include your Windows build (`winver`) and NetBird client version (`netbird version`). diff --git a/src/pages/help/support-matrix/self-hosted.mdx b/src/pages/help/support-matrix/self-hosted.mdx new file mode 100644 index 000000000..06bd164d2 --- /dev/null +++ b/src/pages/help/support-matrix/self-hosted.mdx @@ -0,0 +1,30 @@ +import { Note } from '@/components/mdx' + +export const description = + 'Operating systems and dependencies supported for self-hosted NetBird deployments.' + +# Self-Hosted Support Matrix + +The self-hosted NetBird stack is tested against the operating systems and dependency versions listed below. Running outside the supported window may work but is not covered by bug fixes or security updates. + + + Entries marked **TBD** will be filled in once the support windows are confirmed with the team. + + +## Operating systems + +| OS | Architectures | Version Supported | Status | +|---|---|---|---| +| TBD | TBD | TBD | TBD | +| TBD | TBD | TBD | TBD | + +## Dependencies + +| Component | Minimum version | Version Supported | Status | +|---|---|---|---| +| TBD | TBD | TBD | TBD | +| TBD | TBD | TBD | TBD | + +## Reporting compatibility issues + +If you hit a problem on a supported platform, see [Report bugs and issues](/help/report-bug-issues). Include your deployment topology, host OS, and NetBird version. diff --git a/src/pages/help/support-matrix/terraform-provider.mdx b/src/pages/help/support-matrix/terraform-provider.mdx new file mode 100644 index 000000000..2703b463c --- /dev/null +++ b/src/pages/help/support-matrix/terraform-provider.mdx @@ -0,0 +1,30 @@ +import { Note } from '@/components/mdx' + +export const description = + 'Terraform and NetBird API versions supported by the NetBird Terraform provider.' + +# Terraform Provider Support Matrix + +The NetBird Terraform provider is tested against the Terraform CLI and NetBird API versions listed below. Running against an unsupported combination may work but is not covered by bug fixes or security updates. + + + Entries marked **TBD** will be filled in once the support windows are confirmed with the team. + + +## Terraform CLI versions + +| Provider version | Minimum Terraform | Maximum Terraform | Status | +|---|---|---|---| +| TBD | TBD | TBD | TBD | +| TBD | TBD | TBD | TBD | + +## NetBird API compatibility + +| Provider version | Minimum NetBird API | Latest tested | Status | +|---|---|---|---| +| TBD | TBD | TBD | TBD | +| TBD | TBD | TBD | TBD | + +## Reporting compatibility issues + +If you hit a problem on a supported combination, see [Report bugs and issues](/help/report-bug-issues). Include your provider version, Terraform version (`terraform version`), and NetBird API version.