Super-Slim Edge NGFW (Single-File UEFI UKI)
The Axonwall Super-Slim Edge NGFW (axonwall-edge) is a stateless, memory-only perimeter firewall engineered to sit directly on untrusted WAN links—either as a dedicated bare-metal/virtual appliance or as an isolated Hosted Edge VM orchestrated by an internal Axonwall host. By compiling a hardware-specific monolithic Linux 6.12 LTS kernel (CONFIG_MODULES=n) with axonwall-satellite embedded as a static pure-Go PID 1 (/init), it eliminates every userland shell, package manager, and loadable kernel module.
1. Zero-Surface Monolithic Architecture
Traditional firewall distributions ship hundreds of userland binaries (/bin/sh, bash, python, curl, sshd, libc.so) and thousands of loadable kernel modules (.ko). If an attacker compromises a perimeter service, they immediately leverage those binaries for Living-off-the-Land (LotL) execution or load a kernel rootkit.
The initramfs contains only the static Go binary at /init (compiled with CGO_ENABLED=0) and TLS CA roots. No /bin/sh, busybox, nft CLI, ip CLI, or shared C libraries exist anywhere in the image.
Loadable kernel module support is permanently compiled out of the kernel. The init_module and finit_module syscalls do not exist, making LKM rootkit insertion architecturally impossible.
Built with CONFIG_EFI_STUB=y, UEFI firmware or QEMU/KVM boots axonwall-edge-sku-vm-virtio.efi (~7.0 MB) directly into RAM in under 1.2 seconds without GRUB or any writable disk partition.
On boot, engine/pid1.go mounts /proc, /sys, and /dev, applies hardened kernel sysctls, reaps zombie processes, pets the hardware watchdog, and drives all networking via raw Linux netlink sockets.
2. Pure-Go Netlink Engine & Dual-Stack IPv6
Because no userland CLI tools exist inside the Edge UKI, axonwall-satellite programs the Linux kernel directly over raw netlink sockets:
- 1. Pure-Go
NETLINK_NFTABLESCompiler (engine/nft_netlink.go)Translates desired firewall state into atomic netlink batch transactions—creatingtable inet axonwall, hardware-offloaded fastpath flowtables (CONFIG_NF_FLOW_TABLE_INET=y), stateful conntrack chains, SNAT masquerading, DNAT port forwards, and RFC 4890 Essential ICMPv6 Neighbor Discovery/PMTUD preservation. - 2. Pure-Go
NETLINK_GENERICWireGuard Engine (engine/wg_netlink.go)Creates WireGuard interfaces, injects private keys, and updates peer endpoints and Rosenpass Post-Quantum PSKs directly via Generic Netlink withoutwgoriproute2binaries. - 3. Full Dual-Stack IPv6 & Carrier Engine (
engine/ipv6.go&engine/dhcp4.go)Supports per-interface IPv6 modes (disabled,auto,static,delegated,ula-only), including a native RFC 8415 DHCPv6 client (IA_NAaddress assignment +IA_PDprefix delegation with deterministicDUID-LL), deterministic RFC 4193 ULA subnet generation, and an embedded RFC 4861/8106 Router Advertisement (RA + RDNSS) daemon for downstream LAN segments. - 4. Real-Time Memory Flow & Drop Telemetry (
engine/flow_streamer.go)Harvests live conntrack flows (/proc/net/nf_conntrack) and dropped packet logs (/dev/kmsg) in RAM and streams compressed batches (EDGE_FLOW_BATCH) over mTLS WebSockets to the central Axonwall Hub.
3. Autonomous Zero-Touch Cloud-Init (Zero Python)
The PID 1 binary includes a complete, pure-Go Cloud-Init engine (engine/cloudinit.go) that provisions the unmodified release axonwall-edge-sku-vm-virtio.efi image across any hypervisor or public cloud:
Scans /sys/class/block for cidata or config-2 volumes, mounts iso9660/vfat read-only (MS_RDONLY|MS_NOEXEC), parses user-data & network-config (v1 & v2 Netplan), and immediately unmounts.
Reads /sys/firmware/qemu_fw_cfg/by_name/opt/cloud-init/user-data/raw directly from the hypervisor without attaching any virtual CD-ROM or block device.
Auto-acquires an RFC 2131 DHCPv4 lease on the primary NIC and probes OpenStack, Hetzner, DigitalOcean, AWS EC2 (IMDSv2 token + IMDSv1), GCP, and Azure metadata endpoints.
#cloud-config
hostname: edge-fw-nyc-01
axonwall:
hub: wss://10.0.0.2:2966/ws/satellite
id: edge-fw-nyc-01
token: ztp_axon_9f8e7d6c5b4a3f2e1d0c
sku: sku-vm-virtio
interfaces:
- name: wan
device: eth0
role: wan
address: dhcp
ipv6Mode: auto
- name: lan
device: eth1
role: lan
address: 10.10.0.1/24
ipv6Mode: delegated
ha:
enabled: true
role: master
syncInterface: eth1
peerIp: 10.10.0.2
virtualIps:
- interface: eth1
address: 10.10.0.254/244. Active-Standby Edge HA & Hosted Edge VM Mode
The Edge NGFW supports two deployment topologies—both with sub-second Active-Standby High Availability and hardware watchdog enforcement (/dev/watchdog for QEMU i6300esb or Intel iTCO_wdt):
Flash or boot axonwall-edge-*.efi directly on dedicated Intel N100/Xeon/ARM64 hardware or cloud VMs. Pair two Edge nodes with EdgeHAEngine for UDP heartbeat monitoring, automatic WAN carrier self-fencing on standby, LAN VIP takeover, and stateful conntrack synchronization.
Configured under hostedEdge: in /etc/axonwall/virt.yaml. An Axonwall host binds the physical WAN port into an isolated br-wan bridge with host netfilter bypass and zero host IP addresses, then boots the Edge UKI directly inside a pinned QEMU/KVM micro-VM (-kernel axonwall-edge-sku-vm-virtio.efi). Untrusted WAN packets terminate inside the zero-shell micro-VM before ever reaching the host OS.
hostedEdge:
enabled: true
placement: hosted-vm
ukiSlot: A
skuProfile: sku-vm-virtio
vcpus: 2
memoryMiB: 512
wan:
device: eth0
address: dhcp
ipv6Mode: auto
lan:
device: br-edge-lan
address: 10.254.0.1/30
ipv6Mode: delegated
ha:
enabled: true
role: master
syncInterface: br-edge-lan
peerIp: 10.254.0.2
portForwards:
- protocol: tcp
wanPort: 443
targetIp: 10.254.0.2
targetPort: 443
ipv6Allow:
- destCidr: 2001:db8:10::10/128
protocol: tcp
port: 4435. Manufacturing Hardware SKU Profiles (5 Profiles)
| SKU Profile | Target Platform | Built-in Monolithic Drivers | Compiler Tuning |
|---|---|---|---|
| sku-vm-virtio | KVM / QEMU / Proxmox / Cloud Edge | virtio_net, virtio_pci, i6300esb | -march=x86-64, GOAMD64=v1 |
| sku-x86-intel-n100-i226 | Intel Alder Lake-N (N100/N305) Branch Appliance | igc (2.5GbE i226), igb, e1000e, iTCO_wdt | -march=x86-64-v3 -mtune=alderlake |
| sku-x86-enterprise-10g-25g | 1U/2U Xeon & EPYC Rack NGFW | ixgbe (10G), i40e (25/40G), ice (100G), mlx5_core | -march=x86-64-v3, GOAMD64=v3 |
| sku-arm64-router | ARM64 SoC Gateway (MT7988A / Marvell Armada) | mt7530_dsa, mtk_eth_soc, mvpp2 | -mcpu=cortex-a73+crypto, GOARCH=arm64 |
| base-hardened-ngfw | Baseline Hardened x86_64 Reference Kernel | CONFIG_MODULES=n, nft_flow_table_inet, wireguard, efistub | KSPP Hardened Baseline |
# 1. Download the signed Edge UKI and companion initramfs cpio from GitHub Releases wget https://github.com/axonwall/axonwall/releases/download/v0.13.0/axonwall-edge-sku-vm-virtio.efi wget https://github.com/axonwall/axonwall/releases/download/v0.13.0/axonwall-edge-sku-vm-virtio-initramfs.cpio.gz wget https://github.com/axonwall/axonwall/releases/download/v0.13.0/axonwall-edge-sku-vm-virtio.efi.sha256 sha256sum -c axonwall-edge-sku-vm-virtio.efi.sha256 # 2. Boot the single-file UKI directly into RAM (< 1.2s boot time, zero disk required) qemu-system-x86_64 -enable-kvm -m 512M -smp 2 \ -kernel axonwall-edge-sku-vm-virtio.efi \ -device i6300esb -watchdog-action reset \ -netdev user,id=wan0 -device virtio-net-pci,netdev=wan0 \ -nographic
hostedEdge: in /etc/axonwall/virt.yaml (axonwall-config virt), and manage remote/dedicated Edge UKI satellites under fleet.nodes in /etc/axonwall/ha.yaml or the Web Console at /fleet.