AxonwallOS
AxonwallLinux + nftables
Order
System Blueprint & Technical Specification • v0.13.0

The Linux-Native Hyper-Converged Security Engine

Axonwall v0.13.0 unifies 5 modular core roles & 18 extension plugins (with SHA-256 bundled binaries), 12 bidirectional /etc/axonwall/*.yaml files, lockless Linux 6.12 LTS nftables + Dual-Stack VLAN/LPM CIDR/SYN-Flood XDP packet processing, Custom Hardened Kernels, 5-hook CO-RE BPF-LSM & Linux 6.9+ BPF_TOKEN_CREATE mediation, pure UEFI ZFSBootMenu v3.1.0 & in-kernel Btrfs + Snapper Root, and a guardrailed 25-tool MCP AI control plane.

Control Plane, Ring-0 & Converged Data Plane

 ┌───────────────────────────────────────────────────────────────────────────────────┐
 │  Next.js Console (:2966 TLS) • Neovim TUI (axonwall-config) • Terraform Provider  │
 │  OpenLDAP Multi-Provider syncrepl • OIDC/SAML SSO • 16-Scope / 25-Tool MCP Server │
 └─────────────────────────────────────────┬─────────────────────────────────────────┘
                                           │ Bidirectional 12x /etc/axonwall/*.yaml
                                           │ + Etckeeper /etc Git + Zod Schema Lock
                                           ▼
 ┌───────────────────────────────────────────────────────────────────────────────────┐
 │              Controller (TypeScript) & Privileged Go Daemon (axonwalld)           │
 │       60s Commit-Confirm Watchdog • CSR mTLS HA Engine • Operator-CA Vault        │
 └──────┬──────────────────────────┬──────────────────────────┬──────────────────────┘
        ▼                          ▼                          ▼
 ┌──────────────────────┐  ┌────────────────────────┐  ┌─────────────────────────────┐
 │ Linux 6.12 Dataplane │  │ Ring-0 BPF & Threat AI │  │ 5 Modular Converged Roles   │
 │ • Dual-Stack VLAN XDP│  │ • 5-Hook CO-RE BPF-LSM │  │ • core-firewall (NGFW/FRR)  │
 │ • table inet axonwall│  │   + BPF_TOKEN (6.9+)   │  │ • core-nas (ZFS+ARC/ZIL+S3) │
 │ • table inet         │  │   (CVE-2026-31431 /    │  │ • core-k3s (UserNS+OpenEBS) │
 │   axonwall_mcp (TTL) │  │    io_uring / UserNS)  │  │ • core-virt (KVM/LXC/VFIO)  │
 │ • Rosenpass ML-KEM   │  │ • Coroot eBPF L7 APM   │  │ • core-vigilante (SOAR/SOC) │
 │ • Keepalived + FTFW  │  │ • Suricata 7+ & 8 AVs  │  │ • ZFSBootMenu v3.1.0 & A/B  │
 │                      │  │ • Blackbox Threat-LLM  │  │   (.axonwall-dev rootless)  │
 └──────────────────────┘  └────────────────────────┘  └─────────────────────────────┘
Single Source of Truth

12 Bidirectional /etc/axonwall/*.yaml Domains

GitOps, Etckeeper & YAML Docs

Every edit made in the Web Console, Neovim Super Configurator (axonwall-config), Terraform provider, or vim /etc/axonwall/*.yaml compiles through the same Zod DesiredState schema validator, stages under the 60-second Commit-Confirm watchdog, and versions /etc via Etckeeper Git.

/etc/axonwall/system.yaml

Hostname, 5 core roles, plugins, AI copilot, Eluvix, Coroot eBPF APM, SNMP, UPS & ACME

/etc/axonwall/interfaces.yaml

NIC bindings, 802.1Q/802.1ad VLANs, bridges, LACP bonds, CARP/VRRP VIPs & VRFs

/etc/axonwall/firewall.yaml

Aliases, stateful nftables rules, SNAT/DNAT/Hairpin/1:1 BINAT/NPTv6 & CAKE/FQ-CoDel QoS

/etc/axonwall/routing.yaml

Gateways, Multi-WAN failover/ECMP groups, static routes & FRR (BGP/OSPF/BFD)

/etc/axonwall/services.yaml

Kea DHCPv4/v6 IA_PD + radvd SLAAC, Unbound RPZ, mDNS, UPnP/NAT-PMP, HAProxy & RADIUS

/etc/axonwall/vpn.yaml

WireGuard, Rosenpass Dual-KEM (McEliece + ML-KEM-512), strongSwan IPsec, OpenVPN DCO & Headscale

/etc/axonwall/security.yaml

Suricata 7+, CrowdSec, GeoIP, Zero-Trust IAP, OIDC/LDAP SSO, 5-Hook BPF-LSM, BPF_TOKEN & Blackbox Threat Harvester (threatHarvester)

/etc/axonwall/ha.yaml

2-Host VRRP + conntrackd + CSR mTLS PKI state sync & Satellite Fleet manager

/etc/axonwall/storage.yaml

OpenZFS pools + Special NVMe VDEVs, AES-256-GCM, Checkpoints/TRIM, Time Machine, Cloud Sync & S3

/etc/axonwall/k3s.yaml

Embedded HA K3s, Cilium eBPF CNI + Hubble, Etcd S3 snapshots, UserNS + BPF_TOKEN & OpenEBS CSI

/etc/axonwall/virt.yaml

KVM/QEMU VMs, VirtioFS, Linked Clones, Live Migrate, Libvirt XML, LXC + BPF_TOKEN, VFIO & Edge UKI

/etc/axonwall/vigilante.yaml

Autonomous SOAR containment, honeynet deception mesh, PCAP forensics & 12 SOC packages

Core Architectural Pillars

Dual-Stack QinQ VLAN XDP & Multi-Core nftables

Pre-conntrack eBPF/XDP peels 2-layer 802.1Q/802.1ad VLANs, tracks IPv4/IPv6 flows in BPF_MAP_TYPE_LRU_HASH maps, and executes monotonic TTL XDP_DROP bans while Netfilter flowtables forward stateful traffic locklessly inside table inet axonwall.

Read data plane deep dive
5-Hook CO-RE BPF-LSM & Linux 6.9+ BPF_TOKEN Mediator

Five CO-RE BPF-LSM hooks (lsm/socket_bind, lsm/bpf, lsm/uring_sqpoll, lsm/bpf_token_create, lsm/bpf_token_cmd) block Copy Fail CVE-2026-31431, syscall-less io_uring implants, and cross-tenant UserNS bpf_probe_read_kernel() escapes while delegating safe networking eBPF to rootless K3s & LXC containers.

Ring-0 BPF-LSM & Rootkit guide
Guardrailed 25-Tool MCP AI Across All 5 Duties

axonwall-mcp (disabled by default via hard kill switch) exposes 16 capability scopes, 16 read-only resources, and 25 guardrailed tools spanning Firewall (table inet axonwall_mcp TTL leases), Ring-0 eBPF/BPF_TOKEN, KVM/Libvirt, K3s Etcd, OpenZFS NAS & 9-vendor import.

MCP Security AI architecture
ZFSBootMenu, Btrfs + Snapper, A/B & Edge UKI

Choose pure UEFI ZFSBootMenu v3.1.0 (axonwallctl zbm), in-kernel Btrfs + Snapper Root (@/@snapshots + native RAID-1 + GRUB2 snapshot menu), mdadm RAID-1 A/B Dual-Root (axon_root_a/b) with LUKS2 TPM 2.0 PCR 0+2+7, or the 7.1 MB stateless Edge UKI (axonwall-satellite PID 1).

Boot & Storage architectures
Post-Quantum Rosenpass Dual-KEM VPN

Pairs Classic McEliece 460896 (code-based KEM) + ML-KEM-512 / Kyber-512 (lattice-based KEM) with in-kernel Linux WireGuard, rotating 256-bit Pre-Shared Keys every 120 seconds against Harvest-Now-Decrypt-Later quantum adversaries with zero data-plane overhead.

Post-Quantum VPN architecture
2-Host Full-Stack HA & OpenLDAP Federation

Active/passive clustering with Keepalived VRRP, conntrackd FTFW state sync, CSR-based ECDSA P-256 HA PKI mTLS, Operator-CA preservation, Chrony symmetric NTP, OpenLDAP syncrepl (federating K3s, VOW, Vigilante, Eluvix & RADIUS), 2-node HA K3s + OpenEBS, and ZFS Send/Recv.

2-Host Setup Walkthrough
Coroot eBPF APM & OpenZFS ARC/ZIL Telemetry

Kernel tracepoints, optional TLS uprobes, and 99 Hz FlameGraphs inspect L7 HTTP, gRPC, SQL, Redis, and Kafka flows alongside /proc/spl/kstat/zfs ARC/L2ARC/ZIL storage metrics and automated RCA checks.

eBPF & Observability docs
5 Modular Core Roles: NAS, K3s, KVM & Vigilante SOC

Scale from core-firewall alone to converged core-nas (OpenZFS + SeaweedFS S3), core-k3s (OpenEBS + VOW), core-virt (KVM/LXC/VFIO), and core-vigilante (Autonomous SOAR, honeynet & PCAP forensics).

Modular Core Roles guide
Axonwall Blackbox: Opt-In eBPF Threat-LLM Harvester (ebpf-threat-harvester)

Correlates TCX wire sketches & L7 slices with sched_process_exec, sys_enter_memfd_create, and guarded uprobe/SSL_write (with hardcoded control-plane daemon exclusions). Applies pre-disk DLP secret masking, prefix-preserving AES-128 Crypto-PAn IPv4/IPv6 anonymization, 45s Gold/Silver oracle labeling, OpenZFS zstd spooling, and Dual-Track SFT/RLVR ChatML JSONL + Apache Parquet 1.0 .tar.zst export & AWS SigV4 Vault/S3 shipping.

Read Blackbox Threat-LLM Harvester architecture

Ready to deploy Axonwall v0.13.0?

Explore all 26 engineering guides, test the interactive Web Console sandbox, or download the Ed25519-signed unified quad-edition ISO (NGFW, Minimal, Vault S3 & K3s-Storage) with Custom Hardened Kernel, ZFSBootMenu & Btrfs + Snapper support.