some file

Linux

Updated

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:

  • Ubuntu 20.04, 22.04, 24.04
  • Debian 12
  • Rocky Linux 9
  • Fedora 41

Other distributions are not actively tested; their compatibility follows the mode-specific rules above.

The kernel range below is derived from Go's minimum OS requirements 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.

Linux kernel (userspace mode)

Kernel rangeNetBird release range
3.2 and newerv0.60.3 onwards (Go 1.24+)
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 of which are upstream EOL.

Reporting compatibility issues

See Report bugs and issues. Include your distro, kernel version (uname -r), and NetBird client version (netbird version).