Requirements

Linux Distribution Compatibility

✅ Kernel version compatible
🟢 Some versions have compatible kernel versions
❌ Kernel version not compatible

Distribution	Compatible	Version Requirements	Notes
Debian	✅	13+	Debian 13's default kernel already meets the requirements. Avoid installing NetworkManager.
Arch	✅	Rolling release	The kernel just needs to be new enough. Avoid installing NetworkManager.
Rocky Linux	🟢	Needs upgrade to 6.9+	Also needs NetworkManager removed, firewalld disabled, and SELinux permissions handled.
Armbian	🟢	Needs upgrade to 6.9+	Depends on the specific kernel branch.
OpenWrt	🟢	25+ / snapshot	Requires a custom build; official prebuilt versions are not supported yet.
Alpine	❌	-	Currently incompatible.

Memory Size Limits

Memory use has not yet been optimized for constrained systems. At least 2 GiB is recommended for a standard distribution. A custom minimal system may be able to run with about 1.5 GiB.

Kernel Version

Landscape requires Linux kernel 6.9.x or later.

Required Kernel Configuration

Make sure the kernel build enables the following options:

WARNING

The key requirements are BTF generation, BPF support, and cgroup CPU control.

CONFIG_BPF=y
CONFIG_HAVE_EBPF_JIT=y
CONFIG_ARCH_WANT_DEFAULT_BPF_JIT=y
# BPF subsystem
CONFIG_BPF_SYSCALL=y
CONFIG_BPF_JIT=y
# CONFIG_BPF_JIT_ALWAYS_ON is not set
CONFIG_BPF_JIT_DEFAULT_ON=y
CONFIG_BPF_UNPRIV_DEFAULT_OFF=y
# CONFIG_BPF_PRELOAD is not set
CONFIG_BPF_LSM=y
# end of BPF subsystem
CONFIG_CGROUP_BPF=y
CONFIG_IPV6_SEG6_BPF=y
CONFIG_NETFILTER_BPF_LINK=y
CONFIG_NETFILTER_XT_MATCH_BPF=m
CONFIG_NET_CLS_BPF=m
CONFIG_NET_ACT_BPF=m
CONFIG_BPF_STREAM_PARSER=y
CONFIG_LWTUNNEL_BPF=y
# HID-BPF support
# CONFIG_HID_BPF is not set
# end of HID-BPF support
CONFIG_BPF_EVENTS=y

Kernel BTF Generation Must Be Enabled

Select: Kernel hacking
-> Compile-time checks and compiler options
-> Debug information (Generate DWARF Version 5 debuginfo)
Then in Kernel hacking
-> Compile-time checks and compiler options
you can find the Generate BTF type information option. Enable it.

OpenWrt Build Requirements

The configuration above needs to be enabled in the kernel build options (make kernel_menuconfig).
Additionally, in the OpenWrt build options (make menuconfig), select:

• Global build settings -> Kernel build options
  • Compile the kernel with BPF event support (KERNEL_BPF_EVENTS)
  • Enable kernel cgroups (KERNEL_CGROUPS)
    • Support for eBPF programs attached to cgroups (KERNEL_CGROUP_BPF)
• Network -> Routing and Redirection
  • tc-full Traffic control utility (full) (PACKAGE_tc-full) or
  • tc-bpf Traffic control utility (bpf) (PACKAGE_tc-bpf)

Deselect:

• Global build settings -> Kernel build options
  • Compile the kernel with debug information (KERNEL_DEBUG_INFO)
    • Reduce debugging information (CONFIG_KERNEL_DEBUG_INFO_REDUCED)

Then under Global build settings
-> Kernel build options
-> Compile the kernel with debug information (KERNEL_DEBUG_INFO)
you can see Enable additional BTF type information (CONFIG_KERNEL_DEBUG_INFO_BTF) and select it.