Documentation
recuki
Build Unified Kernel Images (UKIs) from kernel + initramfs + cmdline.
Section
Overview
recuki wraps ukify to produce a single .efi artifact that bundles kernel, initramfs, and command line.
NOTE
Current implementation is marked beta in tool-local docs; keep production rollout explicit.
Section
Usage
Command
bash
recuki -k <KERNEL> -i <INITRD> -c <CMDLINE> -o <OUTPUT> [OPTIONS] Basic UKI build
recuki -k vmlinuz -i initramfs.img -c 'root=LABEL=root rw' -o levitateos.efi UKI build with OS branding metadata
recuki -k vmlinuz -i initramfs.img -c 'root=LABEL=root rw' --os-name LevitateOS --os-id levitateos --os-version 1.0 -o levitateos.efiSection
Key Options
| Option | Description |
|---|---|
-k, --kernel | Kernel image path (vmlinuz) |
-i, --initrd | Initramfs image path |
-c, --cmdline | Kernel command line |
-o, --output | Output UKI file path |
--os-name/--os-id/--os-version | Optional OS branding metadata |
Requirement: ukify must be installed.
Section
Boundaries
- Does: build UKI files
- Does not: sign UKIs, install to ESP, or build initramfs
Section