Modular Core Roles: Firewall, ZFS NAS, K3s, Hypervisor & Vigilante SOC
Axonwall is a hyper-converged, role-modular operating system governed by 5 Core Roles and 18 built-in sandboxed extension plugins (23 total plugins with SHA-256-verified bundled binary archives and on-demand installation on minimal hosts). Disable core-firewall to run as a dedicated Host-Mode ZFS NAS or KVM hypervisor, run as a wire-speed Next-Gen Firewall, or converge all five roles on high-availability bare-metal clusters.
Feature & Architecture Comparison: Axonwall Converged Appliance
Traditional homelab and enterprise infrastructure forced organizations to deploy separate physical appliances or complex nested hypervisors for firewalls, storage, and container runtimes. Axonwall unifies them with native Linux kernel performance, atomic commit-confirm rollback, and zero-drop HA replication.
| Capability / Subsystem | Axonwall Converged OS | Dedicated Storage Appliances | Legacy Firewalls |
|---|---|---|---|
| Core Firewall Engine | Modular plugin (core-firewall), Linux multi-core nftables + Flowtable HW offload | Basic iptables/docker bridges; no NGFW or stateful routing | Monolithic FreeBSD pf (single-lock bottleneck on 10G+) |
| Host-Mode Operation | Yes: Disable firewall to run pure ZFS NAS / K3s host | Default storage host mode only | No (firewall is mandatory and cannot be disabled) |
| Storage Subsystem | Native OpenZFS (Stripe, Mirror, RAID-Z1/Z2/Z3, dRAID) + VSS Shadow Copies | Native OpenZFS (ZFS pool manager) | Root ZFS boot only; no NAS file sharing or RAID management |
| Kubernetes Engine | K3s + OpenEBS distributed CSI (ZFS-LocalPV & Mayastor NVMe-oF) | Deprecated k3s in legacy storage OS (migrated to standard Docker Engine) | None |
| 2-Node True HA | Full state sync: VRRP, conntrackd, SQLite DBs, ZFS snapshots & K3s token auto-join | Dual-controller SAS hardware only; no 2-node commodity HA | CARP + XMLRPC config sync; no file or container replication |
| Hypervisor & Cyber SOC | Native KVM/QEMU + LXC + VFIO (core-virt) & Autonomous SOC (core-vigilante) | Basic VM plugin without NGFW micro-segmentation or SOC | None |
| Firmware Upgrades | A/B Dual-Root partitions or ZFSBootMenu Boot Environments with watchdog | GRUB boot environment snapshots | In-place package upgrade (high brick risk on power loss) |
The 5 Core Appliance Roles (CoreCapabilitiesSchema)
Axonwall encapsulates its foundational subsystem roles into five schema-governed capabilities under capabilities: in /etc/axonwall/system.yaml:
Schema key: firewallEnabled: true. Multi-core line-rate nftables packet filtering, Dual-Stack IPv4/IPv6 + QinQ VLAN eBPF XDP fast-drop, stateful NAT, Suricata 7+ IPS, CrowdSec, GeoIP sets, Unbound DNS RPZ, and FRR BGP/OSPF multi-WAN routing.
Schema key: nasEnabled: true. Enterprise OpenZFS pool & dataset orchestration (/etc/axonwall/storage.yaml): SLOG/L2ARC/hot-spare tiering, SPL kstat ARC/L2ARC/ZIL telemetry, POSIX ACLs, Samba SMB3 with VSS Shadow Copies, NFSv4, iSCSI targets, and SeaweedFS S3 Object-Lock Vault.
Schema key: k3sEnabled: true. Lightweight Kubernetes (/etc/axonwall/k3s.yaml) with bundled k3s & k9s binaries, WireGuard flannel or Cilium eBPF mesh, embedded-etcd HA auto-join over mTLS, Linux 6.9+ UserNamespacesSupport + BPF_TOKEN profiles, and OpenEBS ZFS-LocalPV & Mayastor NVMe-oF storage classes.
axonwall-kubeconfig --vip • Browser Explorer at /k3s/explorerSchema key: virtEnabled: true. Native Type-1 Linux hypervisor (/etc/axonwall/virt.yaml) managing QEMU/KVM virtual machines backed by ZFS zvols, unprivileged LXC containers with Linux 6.9+ BPF_TOKEN delegation, IOMMU PCIe/GPU VFIO passthrough, HTML5 noVNC consoles, and Hosted Virtual Edge UKI micro-VMs.
Schema key: vigilanteEnabled: true (requires k3sEnabled: true). Deploys the Vigilante Autonomous Cyber Operations suite (/etc/axonwall/vigilante.yaml): BattleStation triage, Attack Graph engine, Cyber Deception honeypots, Purple Team emulation, and SOAR playbooks.
18 Built-In Extension Plugins & Bundled Binaries
Beyond the 5 Core Roles, Axonwall includes 18 first-party extension plugins managed declaratively in /etc/axonwall/system.yaml or imperatively via axonwallctl plugin. Three workstation & host-security plugins ship enabled out of the box (unless provisioned with the minimal edition), while fifteen specialized network, VPN, AI, editor, and SecOps plugins remain opt-in to keep the default attack surface minimal.
Plugins such as core-k3s (k3s, k9s), cli-workstation (vim, neovim), and cli-emacs (bundled Debian Emacs shared with cli-emacs-doom / cli-emacs-spacemacs) verify pinned SHA-256 archives before fail-closed extraction into per-plugin bin/ directories, wired automatically into interactive shell PATH snippets and installable on demand from /system/plugins.
| Plugin ID | Default State | Domain YAML | Subsystem Description |
|---|---|---|---|
| cli-workstation | Enabled | system.yaml | Bundled vim & neovim Super Configurator (axonwall-config), Oh My Zsh + Starship shell, Tmux, kubectl & helm v3 |
| host-malware-rootkit | Enabled | security.yaml | Ghost-in-the-Ring 8-scanner host defense + 5-hook CO-RE BPF-LSM Ring-0 & BPF_TOKEN mediator (hostDefense:) |
| coroot-ebpf-apm | Enabled | system.yaml | Zero-instrumentation Ring-0 eBPF service map, TLS uprobes, 99 Hz FlameGraphs, automated RCA, and OpenZFS ARC/ZIL correlation (observability.ebpfApm) |
| ebpf-threat-harvester | Opt-In | security.yaml | Axonwall Blackbox Ring-0 TCX/tracepoint/uprobe flight recorder & Dual-Track SFT/RLVR JSONL + Apache Parquet Threat-LLM dataset harvester (threatHarvester:) |
| rosenpass | Opt-In | vpn.yaml | Post-Quantum Dual-KEM VPN (Classic McEliece 460896 + ML-KEM-512 / Kyber-512) 120s WireGuard PSK rotation |
| eluvix | Opt-In | system.yaml | Sovereign AI Router (:3588 / Switchyard :8080), PrivacyGuard DLP, PromptGuard, and 8 agent harnesses (eluvix:) |
| vigilant-octo-waffle | Opt-In | k3s.yaml | Turnkey K3s DevSecOps & GitOps platform (Argo CD / Flux, Gitea, Vault, Wazuh, Tetragon) under vow: |
| headscale | Opt-In | vpn.yaml | Self-hosted sovereign Tailscale coordination plane with embedded DERP relay and OpenLDAP OIDC integration |
| tailscale | Opt-In | vpn.yaml | Mesh VPN client/subnet-router agent joining either sovereign Headscale or Tailscale SaaS tailnets |
| haproxy | Opt-In | services.yaml | High-performance L4/L7 reverse proxy, TLS/SNI termination, ACME automation, and health-checked backend pools |
| freeradius | Opt-In | services.yaml | 802.1X WPA2/WPA3-Enterprise EAP-TLS / PEAP authentication backed by embedded OpenLDAP |
| snmp | Opt-In | system.yaml | SNMPv2c / SNMPv3 USM encrypted polling & trap daemon (snmpd) exposing IF-MIB and HOST-RESOURCES-MIB |
| nut-ups | Opt-In | system.yaml | Network UPS Tools (ups:) USB/SNMP battery telemetry and graceful ZFS/KVM low-battery shutdown |
| ntopng | Opt-In | system.yaml | Deep packet L7 application DPI traffic classification and historical flow analytics |
| cli-diagnostics-nastymap | Opt-In | system.yaml | Interactive axonwall-tui --nastymap ASCII packet-path & rule-trace topology simulator plus hardware diagnostics |
| cli-emacs | Opt-In | system.yaml | Bundled GNU Emacs runtime (emacs) staged into isolated per-plugin bin/ with interactive shell PATH snippet |
| cli-emacs-doom | Opt-In | system.yaml | Doom Emacs workstation starter sharing the bundled cli-emacs runtime |
| cli-emacs-spacemacs | Opt-In | system.yaml | Spacemacs configuration starter sharing the bundled cli-emacs runtime |
Managing Roles & Plugins via YAML and CLI
Configure Core Roles and extension plugins declaratively in /etc/axonwall/system.yaml (with domain-specific settings in storage.yaml, k3s.yaml, virt.yaml, and vigilante.yaml), or manage plugins directly from the CLI:
version: 1
capabilities:
firewallEnabled: true
nasEnabled: true
k3sEnabled: true
virtEnabled: true
vigilanteEnabled: true
plugins:
- id: cli-workstation
enabled: true
- id: host-malware-rootkit
enabled: true
- id: coroot-ebpf-apm
enabled: true
- id: rosenpass
enabled: true
- id: eluvix
enabled: true
- id: vigilant-octo-waffle
enabled: true# List all 5 Core Roles & 18 extension plugins with live systemd & binary state axonwallctl plugin list # Enable or disable built-in plugins (updates /etc/axonwall/system.yaml & reconciles) sudo axonwallctl plugin enable rosenpass sudo axonwallctl plugin enable eluvix sudo axonwallctl plugin disable snmp # Install, remove, or re-sync plugin packages and systemd sandboxes sudo axonwallctl plugin install vigilant-octo-waffle sudo axonwallctl plugin remove ntopng sudo axonwallctl plugin re-sync host-malware-rootkit