The BenixOS Book

BenixOS is a distributed operating system. It is composed of Kits, speaks the Hearth protocol, and runs on any host that meets a small node contract. This book describes its design, what exists today, and what is still open.

Early, and mostly unreleased

Most of the code described here is not published, and several pieces are drafts. Each chapter opens with a State box that says what is built and what is not. Status is as of 15 November 2026. See About this book.

BenixOS system architecture: applications, Kits, system servers, node contract and wire, node runtime, hosts, hardware

Contents

What it is

  1. What BenixOS is: the plan in one sentence, the vocabulary, the lineage
  2. Architecture: the layers, the three planes, who trusts whom

Foundations

  1. Hearth: the wire contract
  2. Kits: the framework layer and the catalog

The system

  1. Nodes: what makes a machine part of BenixOS
  2. Venue: the registry, the planner and the executor
  3. Grants and enforcement: who may run what, and how that is checked
  4. The gateway and services
  5. Distribution: signed releases of service bundles
  6. Data and identity

Underneath and on top

  1. Hosts and DeviceNix
  2. Building on BenixOS: apps, workloads, the first workload

Practice

  1. The one-node bundle
  2. The security model
  3. Status and roadmap
  4. Open questions

Reference