LevitateOS

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-boot
  • xorriso
  • mtools
  • ukify (only when building UKIs inline)

Section

See Also