Skip to main content
Version: Next

📦 Installation

Get Jibril running in minutes. Choose from simple binary execution, production-ready systemd services, or containerized deployments with Docker and Kubernetes.

🚀 Quick Start​

Choose your deployment method:

Download and run Jibril directly:

sudo curl -L -o /usr/bin/jibril https://github.com/garnet-org/jibril-releases/releases/download/v2.8/loader
sudo chmod +x /usr/bin/jibril

Perfect for: Quick testing, development, single-server deployments

Learn more →

📋 Requirements​

🐧 Linux System​

✅ Kernel Version​

Minimum: Linux 5.10+
Recommended: Linux 6.2+

Check your kernel version
uname -r

Output should be 5.10 or higher.

💻 Architecture​

Supported:

  • ✅ x86_64 (AMD64)
  • ✅ aarch64 (ARM64)

Contact us for other architectures

🐝 eBPF Support​

Jibril requires eBPF support in your kernel. Modern distributions include this by default.

✅ Supported Distributions

  • Ubuntu 22.04+ (all flavors)
  • RHEL/CentOS/Rocky 9+
  • Fedora 36+
  • Debian 11+
  • Amazon Linux 2023
  • Arch Linux (latest)
🔍 Verify eBPF support

Method 1: Check kernel config

zcat /proc/config.gz | grep -E "CONFIG_BPF=|CONFIG_BPF_SYSCALL=|CONFIG_HAVE_EBPF_JIT="

Expected output:

CONFIG_BPF=y
CONFIG_BPF_SYSCALL=y
CONFIG_HAVE_EBPF_JIT=y

Method 2: Use bpftool

Install bpftool:

# Arch Linux
sudo pacman -S extra/bpf
# Ubuntu/Debian
sudo apt install linux-tools-common linux-tools-generic
# Fedora/RHEL
sudo dnf install bpftool

Check available features:

sudo bpftool feature probe

Look for BPF and JIT features marked as available.

🔐 Privileges & Capabilities​

Jibril requires elevated privileges to attach eBPF programs to the kernel.

⚠️ Root Access Required

Jibril must run as root or with specific Linux capabilities.

Required capabilities:

CAP_BPF​

  • Load and manage eBPF programs
  • Kernel: 5.8+ (preferred)

CAP_PERFMON​

  • Performance monitoring events
  • Kernel: 5.8+

CAP_NET_ADMIN​

  • Network observability
  • Kernel: All versions

CAP_SYS_ADMIN​

  • Fallback for older kernels
  • Kernel: Pre-5.8

☸️ Kubernetes Requirements​

📌 Cluster Version​

Minimum: Kubernetes 1.16+ Recommended: 1.25+

kubectl version --short

🔧 Kubectl Access​

Verify cluster connection:

kubectl cluster-info
kubectl get nodes

🔐 RBAC Permissions​

Required permissions:

  • Create DaemonSets
  • Privileged pods
  • Node access

☁️ Cloud Provider Notes​

AWS EKS​

Ensure nodes use Amazon Linux 2 or 3 with kernel 5.10+ and eBPF support enabled.

Google GKE​

Use standard or hardened node images with kernel 5.10+ and eBPF support enabled.

Azure AKS​

All node pools support eBPF on supported kernel versions with kernel 5.10+ and eBPF support enabled.

DigitalOcean DOKS​

Use standard or hardened node images with kernel 5.10+ and eBPF support enabled.

🎯 Next Steps​

💬 Need Help?​

Join our community for support: