Articles
Articles
Background on each part of keelOS: why it is needed, what others do, what we did, the measurements and what is not done yet. The articles are in Chinese for now; each summary below is in English, and a browser's translation works well on them.
Whatever its IP is set to, keelOS can still be found
ESXi wants a monitor and keyboard at the server before its address is right; keelOS does not. kRDPclient's Discover keelOS lists every keelOS on the local network in three seconds, also one without an IP address; double-click, type the admin password, and login, token and the management network all go over a layer-2 channel that carries keel's own TLS. The MikroTik idea, plain UDP sockets on the PC, what the P340 test found, and what is left.
Read the article (Chinese) →
2026-10-19Growing a VM's disk without a restart
A Windows 10 VM kept running while its system disk grew from 64 GiB to 100 GB: change the size on the edit page, save, and the guest gets the new capacity (in Windows, one disk rescan). The notification path for ZFS volumes was there all along; keel just never used it. Grow only, virtio-blk and NVMe disks, and what is not tested yet.
Read the article (Chinese) →
2026-10-15Nested virtualization: bhyve's last gap closed, and Windows VMs run WSL2
keelOS guests can now run hypervisors of their own: KVM in a Linux VM, Hyper-V and WSL2 in a Windows VM, a first for the bhyve family. How keel's VMCS-proxy design made it possible, the five steps from a demo to nested EPT, Hyper-V's unwritten requirements, checkpoints across a host reload, the numbers, and what is left (Intel only, no passthrough, HVCI not yet).
Read the article (Chinese) →
2026-10-14One graphics card cut into seven: integrated GPU SR-IOV for Windows VMs
A Core i5-12600K mini PC gives its UHD 770 to two Windows VMs at once, each with the real Intel driver: WebGL at 60 fps, hardware video decoding, and a remote desktop encoded to H.264 by the VM's own GPU at 60 fps and 22 Mbit/s. How the PF driver lives in the display VM, what Intel's driver expects from the PF, and what is left.
Read the article (Chinese) →
2026-10-15Docker on a BSD hypervisor? Yes, unmodified, in a kcell
keelOS runs the official Docker binaries in a kcell: a tiny Linux VM of its own (a 7.2 kernel, a nolibc init, a read-only system shared by all kcells) whose volumes are the host's ZFS datasets over virtio-fs. Apps first: a Jellyfin template, one-click kcells, docker context over ssh from your own machine. Numbers: 3.9 s cold boot, 1 s resume from a checkpoint, keelfs vs zvol I/O, an iGPU SR-IOV VF transcoding 1080p to 720p HEVC at 73 fps, and what is not done yet.
Read the article (Chinese) →
2026-10-11Public beta: from installing keelOS to the first Windows 10 VM
A step-by-step guide for the public beta: the recommended hardware (8th-10th gen Intel with integrated graphics, two NICs, two disks), writing the USB stick, the installer's disk tools and fresh install, the first visit to the web page, then a Windows 10 VM installed through kRDPclient, the integrated GPU passed through to it and keelagent.
Read the article →
2026-10-08No IPMI on your machine? keelOS makes you one
keelOS runs a tiny Linux VM next to the host, under its hypervisor: it owns the management NIC and answers on the host's own IP while the host reloads, hangs or has a wrong network setting. Its page on port 8623 shows the screen, a serial console you can type in, the hypervisor's log, reset, power-off and a rescue form. With results from a Supermicro test machine and what is not done yet.
Read the article (Chinese) →
2026-10-06System upgrades made simple: try first, confirm later
keelOS upgrades in two steps, an idea taken from ZFS feature flags. The new version is written into the second boot slot and switched to while the VMs only pause; during the trial it keeps writing suspended VM state, settings and pools in the old format, so going back is one more slot switch. Pressing "confirm" moves the formats forward in about a second without stopping VMs. With the test results from our machines, the move from FreeBSD 14.5 to 15.1, and what is not done yet.
Read the article (Chinese) →
2026-10-06keelNAS: a NAS built into keelOS, simple but powerful
Why we made our own NAS instead of only running a full NAS system as a VM: one login and one web interface, a management link inside the host that survives a wrong network setting, signed packages from the market and upgrades that roll back by themselves. SMB, iSCSI, ZFS snapshots, SMART alerts and keelAuth accounts, with the measurements and what is not done yet.
Read the article (Chinese) →
2026-10-03Disk performance: 4K random reads now match KVM
On the same machine, SSD and Linux VM, keelOS now does 81.2k IOPS of 4K random reads at QD32 against KVM's 79.4k (102%), up from 54% two days earlier. Three measured steps: more bhyve worker threads, idle workers polling the virtio ring instead of one VM exit per request, and a PM timer running 720 ppm fast that pushed Linux guests off the TSC. Random and sequential writes still trail.
Read the article (Chinese) →
2026-10-02Running fnOS as a guest: the fourteen things keelOS had to change
fnOS, a popular Chinese NAS system, runs as a VM on an 8 GB mini PC with a whole NVMe drive and the onboard Intel GPU passed through, and transcodes video on that GPU. Getting there took fourteen changes to keelOS, from the guest firmware to the FreeBSD kernel; the article lists each one, what is tested, and what is still open.
Read the article (Chinese) →
2026-10-02How should storage be laid out on an AIO machine?
One machine holds VM disks and NAS data. Four ways to split them, why keelOS keeps two pools with a host that never depends on a VM, three disk layouts (down to a single disk), and test results: a NAS VM with a passed-through NVMe keeps writing across host restarts.
Read the article (Chinese) →
2026-10-02GPU passthrough that works out of the box
What a hypervisor has to get right to hand a graphics card to a VM, what other platforms ask of the user, and how keelOS does it in three clicks: a GTX 1080 Ti in Linux and Windows 10 guests, compute at 97–104% of bare metal, and what is still open.
Read the article (Chinese) →
2026-10-01Can a hypervisor's console be more useful?
The screen attached to a host usually shows an address and then goes stale. keelOS lets the hypervisor own the screen, so it stays readable while the host restarts or crashes, and Ctrl-Alt-F2, F3 … switch the same monitor and keyboard to each VM. The serial side is planned.
Read the article (Chinese) →
2026-10-0199.99% uptime at home: is it hard?
99.99% allows 52 minutes of downtime a year. What eats that budget on a home server (host updates, reboots, power) and how keelOS keeps VMs running through host restarts, with the test results.
Read the article (Chinese) →
2026-09-30An AIO system for the NAS enthusiast
One box for the NAS, the router and the desktops: how keelOS passes the disk controller to a NAS VM, keeps it running while the host restarts (24–26 s pause, 100 restarts in a row) and what is still missing.
Read the article (Chinese) →
2026-09-30How hard is it to keep a VM's clock right?
What a 25-second pause does to a guest's clock, how other hypervisors handle it, and how keelOS keeps FreeBSD and Linux guests within ±0.4 s after dozens of host restarts.
Read the article (Chinese) →
2026-09-30Every mainstream router system, run on keelOS
OpenWrt, ImmortalWrt, iStoreOS, OPNsense, pfSense CE, VyOS and RouterOS CHR in VMs: network setups, SR-IOV VFs, and how keelOS prevents bridging the office LAN into a loop.
Read the article (Chinese) →
2026-09-30One-click VMs, like Docker apps? (outlook)
Ready-made VM templates installed with one click, the way app stores work for containers: what it would take and what keelOS plans. An outlook, not a feature yet.
Read the article (Chinese) →
2026-09-30ZFS underneath: moving VMs without losing data (cold migration works)
Each VM is one ZFS dataset tree: settings, firmware variables and disks snapshot together. How that lets zfs send move a VM: cold migration works since 2026-10-07; migration with memory is planned.
Read the article (Chinese) →
2026-09-30CPU and disks can be overcommitted. What about memory?
On our host, 49% of 44 GB of guest memory was zero pages after a day. How keelOS reclaims them and lends them to the host as disk cache without overcommitting.
Read the article (Chinese) →
2026-09-30Old systems are welcome too
IDE, PCnet, UHCI and SeaBIOS added to bhyve, so Windows XP, Server 2003 and Windows 7 install with the drivers they ship with.
Read the article (Chinese) →
2026-09-29PCIe passthrough and SR-IOV
Giving a VM a whole disk controller, NVMe drive or network VF, and keeping DMA working while the host restarts: 14 restarts under full write load, no timeouts, scrub with zero errors.
Read the article (Chinese) →
2026-09-29Windows 11 needs TPM 2.0
A virtual TPM 2.0 and Secure Boot for each VM: Windows 11 installs without registry tricks, BitLocker works, and the TPM state survives host restarts.
Read the article (Chinese) →