Files
KeruOS/README.md
T

2.5 KiB

Keru OS ける

An independent, source-only Linux distribution built around one idea: you don't install a system, you craft one — ける・けいとうてき (keru keitō-teki): a system assembled the way you want it.

This repository holds the operating system itself — the installer, the ISO build tooling, the profile system, and the build pipeline. The two things Keru depends on live in their own repositories:

  • kama — the package manager (a shell script)
  • kama-packages — the recipe repository

What is Keru

Every package on Keru is built from source by Kama, a deliberately small package manager that simply runs the commands in each recipe. No binary packages, no opaque package machinery. The whole system — toolchain included — is compiled from original source.

Nothing is fixed. Nothing you didn't ask for is forced on you.

The differentiator: everything is swappable

Keru's installer is a TUI that walks you through designing your exact machine before it ever boots. Every major component is selectable:

  • init system — Runit (default), s6, OpenRC, systemd, busybox init, and more
  • C library — glibc, musl, uClibc-ng, and more
  • filesystem — ext4, btrfs, xfs, zfs, f2fs, jfs, reiserfs, swap, and more
  • kernel — linux, linux-lts, linux-hardened, linux-cachyos, and more
  • kernel parameters, locale, clock, keymap — all configurable

Every init, every libc, every filesystem, everything. The selections are made during install and fixed at first boot. The system that lands on your disk is precisely the one you chose.

Repository layout

installer/     TUI installer — writes make.conf from your choices
profile/       make.conf template (the swappables + build flags)
scripts/       build pipeline: build-root, mkfs-root, common helpers
docs/          design docs + the recipe format spec

(ISO build tooling is not in this repo yet — coming later.)

Building

The three repos should sit next to each other (or point at each other via KAMA_DIR / PKGS_DIR / PKGDIR):

~/dev/
├── KeruOS/
├── kama/
└── kama-packages/

Then, from KeruOS/:

make install       # run the TUI installer
# or, headlessly:
sh scripts/build-root.sh            # build a rootfs into /tmp/keru/root

Requires the sibling kama and kama-packages repos to be present.

Status

Design + scaffolding. Nothing is building end-to-end yet.

License

AGPL-3.0