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.
| Command | Purpose |
|---|---|
build-tiny | Build the live ISO initramfs (busybox-based): find the boot medium, mount the EROFS rootfs and live overlay, switch_root |
build-install | Build an initramfs for booting an installed system from disk (busybox-based, the same for both distros) |
modules | List 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 (
--templatereplaces 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
- reciso - Build bootable ISO