Supported Distributions

Per-architecture capability matrix and per-distribution support matrix for the LinuxGuard agent — Debian, RedHat, SUSE, Alpine across amd64, arm64, armv7, and riscv64.

LinuxGuard supports a range of Linux distributions across four family lines (Debian, RedHat, SUSE, Alpine) on multiple CPU architectures. This page is the canonical reference for which architecture × distribution combinations ship a working agent binary, and what the runtime feature surface looks like on each.

Important: Architecture support is per-capability, not binary. On ARMv7 the agent runs in DegradedNoEBPFArch mode with no eBPF probes ever — see the Multi-Architecture Support page for the full callout. The matrix below carries the same source-verified status.

Architecture Capability Matrix

The columns describe the granular surface every per-architecture deployment MUST reason about. A single "Supported" column would conflate the build-time eBPF availability with the runtime feature surface.

Arch	Binary	eBPF probes	Behavioral telemetry	Auth events	File monitor	CI-tested
amd64 (x86_64)	Yes	Yes (full clang/LLVM compile)	Yes	Yes	Yes	Yes
arm64 (aarch64)	Yes	Yes (full clang/LLVM compile)	Yes	Yes	Yes	Yes
armv7 (arm)	Yes	No (.skip sentinel; loader falls back to DegradedNoEBPFArch)	No	Limited (no eBPF-derived events)	Limited (no eBPF-derived events)	Best-effort
riscv64	Yes	Best-effort (clang attempt; .skip on toolchain failure)	Conditional (depends on probe success)	Conditional	Conditional	No
s390x	Unverified — do not rely on without confirmation against latest source build	Unverified	Unverified	Unverified	Unverified	No
ppc64le	Unverified — do not rely on without confirmation against latest source build	Unverified	Unverified	Unverified	Unverified	No

For the column definitions and the runtime fallback flow, see Multi-Architecture Support.

Per-Distribution Architecture Support

Each distribution family ships agent packages for the architectures listed below. Distribution order is fixed across this documentation set: Debian/Ubuntu → RedHat/CentOS → SUSE → Alpine.

Distribution Family	amd64	arm64	armv7	riscv64	Minimum kernel	Package repo
Debian / Ubuntu	Yes	Yes	Yes (Degraded mode)	No	4.18	packages.linuxguard.io/apt
RedHat / CentOS	Yes	Yes	No	No	4.18	packages.linuxguard.io/dnf
SUSE / openSUSE	Yes	Yes	No	No	4.18	packages.linuxguard.io/zypper
Alpine	Yes	Yes	Yes (Degraded mode)	Best-effort	4.18	packages.linuxguard.io/apk

ARMv7 packages on Debian/Ubuntu and Alpine install the agent binary, but the resulting deployment runs in Degraded mode with no eBPF-derived telemetry. Plan compliance and detection-coverage assumptions accordingly.

Distribution Families

LinuxGuard organizes support by distribution families, which share similar package management systems and system architectures.

Debian-based Systems

LinuxGuard supports all Debian-based distributions that use the APT package manager.

Supported Distributions:

• Debian: All currently supported versions (Debian 10+, including Debian 11 "Bullseye", Debian 12 "Bookworm")

• Ubuntu: All LTS and current versions (Ubuntu 20.04+, including 22.04, 24.04)

• Linux Mint: Versions based on supported Ubuntu LTS releases

• Other Debian derivatives: Any distribution using APT package management

Package Manager: APT (Advanced Package Tool)

Repository Setup: Uses the Debian/APT repository format

RedHat-based Systems

LinuxGuard supports RedHat-based distributions that use YUM or DNF package managers.

Supported Distributions:

• Red Hat Enterprise Linux (RHEL): RHEL 7, 8, 9 and later versions

• CentOS: CentOS 7, 8, and CentOS Stream

• Fedora: Current and recent Fedora releases (Fedora 35+)

• Rocky Linux: All versions

• AlmaLinux: All versions

• Oracle Linux: Versions compatible with RHEL

• Amazon Linux: Amazon Linux 2 and Amazon Linux 2023

Package Manager: DNF (or YUM on older systems)

Repository Setup: Uses the YUM/DNF repository format

openSUSE/SLES-based Systems

LinuxGuard supports openSUSE and SUSE Linux Enterprise Server distributions.

Supported Distributions:

• openSUSE Leap: 15.x and later versions

• openSUSE Tumbleweed: Rolling release

• SUSE Linux Enterprise Server (SLES): SLES 15 and later

Package Manager: Zypper

Repository Setup: Uses the Zypper repository format

Alpine-based Systems

LinuxGuard supports Alpine Linux and Alpine-based distributions.

Supported Distributions:

• Alpine Linux: Alpine 3.14+ (all currently supported versions)

Package Manager: APK (Alpine Package Keeper)

Repository Setup: Uses the Alpine APK repository format

System Requirements

Minimum Requirements

• Kernel: Linux kernel 4.18 or later (required for eBPF runtime detection on supported architectures)

• Architecture: See the architecture capability matrix above

• Disk Space: 100 MB for agent installation

• Memory: 50 MB RAM for agent operation

• Network: Outbound HTTPS connectivity to api.linuxguard.io

• Permissions: Root or sudo access for installation and configuration

Recommended Requirements

• Disk Space: 500 MB (for logs and temporary files)

• Memory: 100 MB RAM

• Network: Stable internet connection for real-time telemetry

Installation Methods

LinuxGuard uses a unified installer script that automatically detects your distribution and configures the appropriate package repository:

curl -fsSL https://packages.linuxguard.io/install-linuxguard.sh | sudo bash

The installer supports all distribution families listed above and handles:

• Automatic distribution detection

• Repository configuration for your package manager (APT, DNF/YUM, Zypper, or APK)

• Package installation

For installation options and examples, see the Installation Guide.

Version Support Policy

LinuxGuard maintains support for:

• All currently supported versions of each distribution

• LTS (Long Term Support) versions for distributions that offer them

• Recent stable releases

For questions about support for specific distribution versions, contact [e-mail].

---

Related: Multi-Architecture Support | Installation | Prerequisites | Troubleshooting