home / docs / release process

Release process

How a release leaves the kiln.

Keru's releases are honest about being releases: each one is a tested point in time of the three repos, assembled into an ISO that boots and installs without fanfare.

Versioning

keru-0.1.0.iso # {major}.{minor}.{patch}
BumpWhen
majorThe swappable set changes shape, or the philosophy moves — real milestones like the first ISO.
minorNew swappable or a new kama feature that stays backward-compatible.
patchRecipe fixes, installer bugfixes, docs — anything that changes no contracts.

What the release ISO contains

  • The installer. installer/install.sh plus its payload.
  • The live init. live/init — boot the ISO, installer auto-runs.
  • The repos. kama and kama-packages pinned at the release commit.
    Everything else — every source tarball, every toolchain compile — is fetched and built at install time.

Release readiness

CheckWhat passes it
Combos bootThe proven set of the offered swappables all boot after install.
Installer cleanA full install from a cold boot, no keyboard runtime.
No blockersNothing warns-but-doesn't-block where it shouldn't; unproven combos warn loudly.
Docs matchmake.conf, recipes, and this website agree with the shipped code.

Announcements

Releases are announced on the news page, with a changelog and the exact repos/commits the ISO was cut from. "0.1 when it's ready" — as tracked in the status above — remains the only roadmap.

Deliberately unglamorous. A release is a checkpoint the community can trust, not a marketing event. Read the news for the current one.

Contribute · → Status / news