中文日本語

About

Who makes keelOS, and what you can rely on

Who makes it

keelOS is an independent project, built since September 2026 on FreeBSD, bhyve and OpenZFS. It is not open source and it is free to use (see the licence below).

  • Bugs, questions and hardware reports: GitHub Issues.
  • Releases and release notes: GitHub Releases.
  • There is no forum or chat group yet. When there is one, it will be listed here.

Contact

For anything that is not a bug report, write to us. We read every message; a reply can take a few days.

  • Commercial licence, partnerships, OEM: [email protected].
  • Sponsoring the project, or lending hardware for testing: [email protected]. GitHub Sponsors for keelos-dev is being set up and will be linked here when it opens.
  • Everything else (press, questions that do not fit an issue): [email protected].
  • Bugs and hardware reports still go to GitHub Issues, where others can find them.

If the project stops, your data does not

Nothing in keelOS stores your VMs in a format only keelOS can read.

  • Disks are ZFS volumes (zvols) or plain image files in an ordinary ZFS pool called zones, one dataset per VM. Any current OpenZFS system (FreeBSD, Linux, TrueNAS, Proxmox VE) can zpool import zones and read them.
  • A zvol is a raw disk. Copy it with dd or zfs send, attach it to a Proxmox VM with qm disk import, or point bhyve or QEMU at /dev/zvol/zones/….
  • VM settings are one readable JSON file per VM (CPUs, memory, disks, network cards with their MAC addresses, firmware). The host settings are JSON and FreeBSD rc.conf files on the boot partition.
  • The guests use standard devices (virtio, NVMe, AHCI, e1000), so they boot on another hypervisor with the drivers they already have. A Windows guest with BitLocker asks for its recovery key when it moves to a new virtual TPM, as it would on any platform: keep that key.

What it sends over the network

  • No telemetry, no account, no update check. keelOS opens no connection to us or anyone else on its own.
  • It downloads something only when you give it an address: an installer ISO for a VM, or an upgrade image.
  • While you have the Market page open, it reads the list of packages from github.com/keelos-dev/keelOS-releases (at most every 10 minutes, sending nothing but the request) and downloads a package when you click Download. The address of the list can be changed to your own mirror.
  • On your local network it announces itself by mDNS, so that https://<hostname>.local/ works.
  • This website has no tracking scripts.

Checking an image

Each release lists the SHA-256 checksum of its ISO next to the download. The upgrade page of the web interface shows the SHA-256 of the image you upload or download, so you can compare it before you switch to it. Release images are not signed yet; when they are, the public key will be published on this page.

Security model

  • The hypervisor is small. The part that holds guest memory and owns the IOMMU is about 100 KB. The FreeBSD host runs from a read-only image (the base system in RAM, /usr from the boot disk); an upgrade replaces the whole image.
  • The first person to open the web interface sets the administrator password. Install keelOS on a network you trust and set the password straight away. It is also the password for SSH (root) and for RDP to the VM consoles; before it is set, SSH accepts keys only. keel admin reset on the local console clears it.
  • The web interface and the API use HTTPS with a certificate the host makes for itself (its SHA-256 fingerprint is in the host's log). Everything the web interface does goes through the same API.
  • Tokens are scoped. Each API token says what it may do, on which VMs, from which addresses and until when. Every change is written to the audit log with the token that made it.

Licence

  • Personal use is free.
  • Commercial use is also free, with our permission; in return we list your company's name on this site.
  • The licence text is published with the first release. To ask for permission, write to [email protected].
  • The licence notices of FreeBSD, bhyve, OpenZFS and the other components ship with every image.
  • keelNAS and keelAuth, the VMs in the Market, are open source under the BSD 2-Clause licence.

Frequently asked questions →