Core Appliance System Architecture • v0.13.0

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 / SubsystemAxonwall Converged OSDedicated Storage AppliancesLegacy Firewalls
Core Firewall EngineModular plugin (core-firewall), Linux multi-core nftables + Flowtable HW offloadBasic iptables/docker bridges; no NGFW or stateful routingMonolithic FreeBSD pf (single-lock bottleneck on 10G+)
Host-Mode OperationYes: Disable firewall to run pure ZFS NAS / K3s hostDefault storage host mode onlyNo (firewall is mandatory and cannot be disabled)
Storage SubsystemNative OpenZFS (Stripe, Mirror, RAID-Z1/Z2/Z3, dRAID) + VSS Shadow CopiesNative OpenZFS (ZFS pool manager)Root ZFS boot only; no NAS file sharing or RAID management
Kubernetes EngineK3s + OpenEBS distributed CSI (ZFS-LocalPV & Mayastor NVMe-oF)Deprecated k3s in legacy storage OS (migrated to standard Docker Engine)None
2-Node True HAFull state sync: VRRP, conntrackd, SQLite DBs, ZFS snapshots & K3s token auto-joinDual-controller SAS hardware only; no 2-node commodity HACARP + XMLRPC config sync; no file or container replication
Hypervisor & Cyber SOCNative KVM/QEMU + LXC + VFIO (core-virt) & Autonomous SOC (core-vigilante)Basic VM plugin without NGFW micro-segmentation or SOCNone
Firmware UpgradesA/B Dual-Root partitions or ZFSBootMenu Boot Environments with watchdogGRUB boot environment snapshotsIn-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:

core-firewall
DEFAULT ON

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.

When toggled off: Compiles an atomic Host-Mode ruleset permitting management, SMB/NFS/iSCSI, KVM bridges, and K3s node traffic without router forwarding.
core-nas
OPT-IN

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.

HA Failover: Incremental ZFS send/recv streams with automatic VRRP MASTER promotion.
core-k3s
OPT-IN

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.

Kubeconfig & UI: Synced via axonwall-kubeconfig --vip • Browser Explorer at /k3s/explorer
core-virt
OPT-IN

Schema 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.

core-vigilante
REQUIRES core-k3s

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.

SHA-256 Bundled Binary Supply Chain & On-Demand Provisioning

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 IDDefault StateDomain YAMLSubsystem Description
cli-workstationEnabledsystem.yamlBundled vim & neovim Super Configurator (axonwall-config), Oh My Zsh + Starship shell, Tmux, kubectl & helm v3
host-malware-rootkitEnabledsecurity.yamlGhost-in-the-Ring 8-scanner host defense + 5-hook CO-RE BPF-LSM Ring-0 & BPF_TOKEN mediator (hostDefense:)
coroot-ebpf-apmEnabledsystem.yamlZero-instrumentation Ring-0 eBPF service map, TLS uprobes, 99 Hz FlameGraphs, automated RCA, and OpenZFS ARC/ZIL correlation (observability.ebpfApm)
ebpf-threat-harvesterOpt-Insecurity.yamlAxonwall Blackbox Ring-0 TCX/tracepoint/uprobe flight recorder & Dual-Track SFT/RLVR JSONL + Apache Parquet Threat-LLM dataset harvester (threatHarvester:)
rosenpassOpt-Invpn.yamlPost-Quantum Dual-KEM VPN (Classic McEliece 460896 + ML-KEM-512 / Kyber-512) 120s WireGuard PSK rotation
eluvixOpt-Insystem.yamlSovereign AI Router (:3588 / Switchyard :8080), PrivacyGuard DLP, PromptGuard, and 8 agent harnesses (eluvix:)
vigilant-octo-waffleOpt-Ink3s.yamlTurnkey K3s DevSecOps & GitOps platform (Argo CD / Flux, Gitea, Vault, Wazuh, Tetragon) under vow:
headscaleOpt-Invpn.yamlSelf-hosted sovereign Tailscale coordination plane with embedded DERP relay and OpenLDAP OIDC integration
tailscaleOpt-Invpn.yamlMesh VPN client/subnet-router agent joining either sovereign Headscale or Tailscale SaaS tailnets
haproxyOpt-Inservices.yamlHigh-performance L4/L7 reverse proxy, TLS/SNI termination, ACME automation, and health-checked backend pools
freeradiusOpt-Inservices.yaml802.1X WPA2/WPA3-Enterprise EAP-TLS / PEAP authentication backed by embedded OpenLDAP
snmpOpt-Insystem.yamlSNMPv2c / SNMPv3 USM encrypted polling & trap daemon (snmpd) exposing IF-MIB and HOST-RESOURCES-MIB
nut-upsOpt-Insystem.yamlNetwork UPS Tools (ups:) USB/SNMP battery telemetry and graceful ZFS/KVM low-battery shutdown
ntopngOpt-Insystem.yamlDeep packet L7 application DPI traffic classification and historical flow analytics
cli-diagnostics-nastymapOpt-Insystem.yamlInteractive axonwall-tui --nastymap ASCII packet-path & rule-trace topology simulator plus hardware diagnostics
cli-emacsOpt-Insystem.yamlBundled GNU Emacs runtime (emacs) staged into isolated per-plugin bin/ with interactive shell PATH snippet
cli-emacs-doomOpt-Insystem.yamlDoom Emacs workstation starter sharing the bundled cli-emacs runtime
cli-emacs-spacemacsOpt-Insystem.yamlSpacemacs 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:

/etc/axonwall/system.yaml
yaml
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
CLI Plugin Lifecycle Management (axonwallctl plugin)
bash
# 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