Documentation
reciso
Create bootable UEFI ISOs from kernel, initramfs, and EROFS rootfs.
Section
Overview
reciso builds UEFI bootable media and can include prebuilt UKIs or build UKIs inline.
NOTE
Current implementation is marked beta in tool-local docs.
Section
Usage
Command
bash
reciso -k <KERNEL> -i <INITRD> -r <ROOTFS> -l <LABEL> -o <OUTPUT> [OPTIONS] Basic ISO build
reciso -k vmlinuz -i initramfs.img -r filesystem.erofs -l LEVITATEOS -o levitate.iso Build ISO and inline UKIs
reciso -k vmlinuz -i initramfs.img -r filesystem.erofs -l LEVITATEOS --build-uki 'Normal::levitateos.efi' --build-uki 'Emergency:emergency:levitateos-recovery.efi' -o levitate.iso Select payload layout explicitly
reciso -k vmlinuz -i initramfs.img -r filesystem.erofs -l LEVITATEOS --live-payload-layout appended-partitions -o levitate.iso Section
Important Options
| Option | Description |
|---|---|
--uki <PATH> | Include prebuilt UKI (repeatable) |
--build-uki <name:extra_cmdline:filename> | Build UKI inline |
--extra-file <SRC:DST> | Add extra payload file to ISO |
--overlay-image <PATH> | Include live overlay image (EROFS) |
--live-payload-layout <iso-files|appended-partitions> | Choose live payload placement strategy |
--no-checksum | Skip checksum generation |
Section
Requirements
systemd-bootxorrisomtoolsukify(only when building UKIs inline)
Section