Zero-Surface Perimeter • Single-File UEFI UKI • v0.13.0

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.

Zero Shell & Zero LotL Surface

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.

Total LKM Immunity (CONFIG_MODULES=n)

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.

Sub-1.2s UEFI Stub Boot into RAM

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.

Pure-Go PID 1 Lifecycle

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.

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:

NoCloud & ConfigDrive

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.

QEMU fw_cfg Direct Seed

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.

Cloud IMDS (169.254.169.254)

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.

Example #cloud-config for Zero-Touch Edge UKI Provisioning
yaml
#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/24

4. 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):

Mode A: Dedicated Bare-Metal / Cloud VM

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.

Mode B: Hosted Edge VM Inside Axonwall Host

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.

/etc/axonwall/virt.yaml — Hosted Virtual Edge NGFW Schema
yaml
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: 443

5. Manufacturing Hardware SKU Profiles (5 Profiles)

SKU ProfileTarget PlatformBuilt-in Monolithic DriversCompiler Tuning
sku-vm-virtioKVM / QEMU / Proxmox / Cloud Edgevirtio_net, virtio_pci, i6300esb-march=x86-64, GOAMD64=v1
sku-x86-intel-n100-i226Intel Alder Lake-N (N100/N305) Branch Applianceigc (2.5GbE i226), igb, e1000e, iTCO_wdt-march=x86-64-v3 -mtune=alderlake
sku-x86-enterprise-10g-25g1U/2U Xeon & EPYC Rack NGFWixgbe (10G), i40e (25/40G), ice (100G), mlx5_core-march=x86-64-v3, GOAMD64=v3
sku-arm64-routerARM64 SoC Gateway (MT7988A / Marvell Armada)mt7530_dsa, mtk_eth_soc, mvpp2-mcpu=cortex-a73+crypto, GOARCH=arm64
base-hardened-ngfwBaseline Hardened x86_64 Reference KernelCONFIG_MODULES=n, nft_flow_table_inet, wireguard, efistubKSPP Hardened Baseline
Download & Boot the Official v0.13.0 Edge UKI & Companion Initramfs in QEMU/KVM
bash
# 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
Manage from Fleet Console, Neovim TUI, or Canonical YAML
Orchestrate Hosted Virtual Edge NGFWs via 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.