Docs: recinit

Documentation

recinit

Rootless initramfs builder for the live ISO and installed systems.

Overview

recinit builds initramfs images without requiring root or external generators such as dracut or mkinitcpio. It writes the CPIO archive itself, resolves boot modules against the kernel's modules.dep, and stores them in load order.

CommandPurpose
build-tinyBuild the live ISO initramfs (busybox-based): find the boot medium, mount the EROFS rootfs and live overlay, switch_root
build-installBuild an initramfs for booting an installed system from disk (busybox-based, the same for both distros)
modulesList module presets and the modules in each

Usage

Options as printed by recinit --help:

Text
Rootless initramfs builder for Linux

Usage: recinit [OPTIONS] <COMMAND>

Commands:
  build-tiny     Build a tiny initramfs for live ISO boot
  build-install  Build the busybox initramfs that boots an installed system (either distro)
  help           Print this message or the help of the given subcommand(s)

Options:
  -q, --quiet    Quiet mode (suppress progress messages)
  -h, --help     Print help
  -V, --version  Print version

Build an initramfs for an installed system:
  recinit build-install --rootfs /mnt --busybox /path/to/busybox-static \
    --modules-dir /mnt/usr/lib/modules/<KERNEL-VERSION> --output initramfs-installed.img

Use build-tiny for live ISO boot and build-install for an installed system.
The module tree must match the kernel you will boot. No root privileges needed.
Run 'recinit <command> --help' for the required inputs.

Notes

  • Tiny/live: takes the kernel's module tree, a static busybox and the ISO label; the init template is built in (--template replaces it)
  • Install: takes the staged rootfs, its module tree and a static busybox for the emergency shell; firmware is copied unless --no-firmware
  • Preset control: named presets (live, install) or a comma-separated module list

See Also