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 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. Include your operator version, Kubernetes version (kubectl version), and NetBird control-plane version.