中文日本語

Why keelOS

One machine. Nothing has to stop.

Home servers and small offices run everything on one box: the NAS, the router, a Windows desktop, a few Linux servers. keelOS was built for exactly that box, and the same image runs the rows of hosts in a data centre, managed from one place. Each point below was measured on real hardware; the linked articles (in Chinese) have the details.

What happens to the VMs when the host restarts

SystemOrdinary VMsNAS VM with its disk controller passed through
Unraid 7Shut down, or hibernated by the guest OS (needs the guest agent)None: the host itself is the NAS
TrueNAS SCALEShut down and started againNone: the host itself is the NAS
Proxmox VE 9Shut down and started again; suspend to disk only by handShut down and started again
Hyper-V (Windows Server, DDA)Saved to disk, restored after the restartShut down (Save is not allowed with passed-through devices)
ESXi 8Can be suspended to disk, resumed after the restartShut down and started again (cannot be suspended)
keelOSPaused for about 25 s in memory; TCP connections stay upThe same: paused for about 25 s, the controller keeps running

Suspend and save write the VM's memory to disk and read it back after the restart; this takes longer the more memory the VM has, and none of the platforms above allows it for a VM with passed-through devices (sources below). Data centres move VMs to a second machine before a host restart. At home there is no second machine.

Sources: Unraid 7.0 release notes · Proxmox forum: hibernate on host reboot · Proxmox forum: snapshots with passthrough · Microsoft: Discrete Device Assignment · VMware: DirectPath I/O · Broadcom KB 428701

01

Host updates do not stop the VMs

A small hypervisor holds guest memory and vCPU state and stays in memory while the FreeBSD host is upgraded and restarted. Guests pause for 24–26 s with TCP connections intact. 100 host restarts in a row without a failure; 17 VMs resumed together after one restart.

99.99% uptime at home: is it hard? →

An AIO system for the NAS enthusiast →

02

Passthrough that survives the restart

The NAS VM gets the whole disk controller or NVMe drive and sees real disks: SMART, write cache, real errors. The hypervisor owns the IOMMU, so DMA keeps working while the host restarts: 14 restarts under full write load, no timeouts, ZFS scrub with zero errors. SR-IOV VFs for the network.

Read the article (Chinese) →

03

Windows 11 just installs

A virtual TPM 2.0 and Secure Boot pass the installer's check without registry tricks. BitLocker works, and the TPM state survives host restarts.

Read the article (Chinese) →

04

Memory that is not wasted

On our development host, 49% of 44 GB of guest memory was zero pages after a day. keelOS reclaims them and lends them to the host as disk cache, and gives them back the moment a guest writes. No overcommit: the memory can always be returned.

Read the article (Chinese) →

05

Clocks that stay right

A pause is invisible to the guest's clock: after dozens of host restarts FreeBSD and Linux guests are within ±0.4 s. Windows Server 2003 no longer runs 3.6% slow.

Read the article (Chinese) →

06

From Windows XP to Windows 11

keelOS added IDE, PCnet and UHCI devices and SeaBIOS to bhyve, so XP and Server 2003 install with the drivers they ship with. Nothing to add to the guest.

Read the article (Chinese) →

07

Your router in a VM

OpenWrt, ImmortalWrt, iStoreOS, OPNsense, pfSense CE, VyOS and RouterOS CHR all run, most with an SR-IOV VF of the network card. keelOS stops the classic mistake of bridging the office LAN into a loop.

Read the article (Chinese) →

08

ZFS underneath

Each VM is one ZFS dataset tree: configuration, firmware variables and disks snapshot together. Cold migration to another keelOS host with zfs send works, driven from the management VM; migration with memory is planned.

Read the article (Chinese) →

09

Light by design

One read-only system image, one management program with no database, a web interface, command line and HTTPS API. RDP straight to any VM's screen, with nothing installed in the guest.

Details →