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, and the install image is assembled by hand rather than with a stock tool like archiso.
Runit handles services. The standard Linux kernel drives the hardware.
nmtui manages networking. Nothing you didn't ask for ends up on the disk.
The differentiator: craft your system at install time
Keru's installer is a TUI that walks you through designing your exact machine before it ever boots:
- init system — Runit (default), s6, OpenRC, systemd
- C library — glibc or musl
- filesystem — ext4, btrfs, xfs, zfs, f2fs
- kernel — linux, linux-lts, linux-hardened
Swappable at install time, 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
iso/ from-scratch ISO build tooling (xorriso + squashfs + syslinux)
profile/ make.conf template (the swappables + build flags)
scripts/ build pipeline: build-root, mkfs-root, common helpers
docs/ design docs + the recipe format spec
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
make iso # assemble an install image
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