limine-entry-tool

helper script for managing Limine bootloader entries on UEFI systems

TLDR

Scan for active UEFI boot entries and add them to Limine menu

$ limine-entry-tool --scan

Add a new kernel boot entry with initramfs and kernel file

$ limine-entry-tool --add "[kernel_name]" "[path/to/initramfs]" "[path/to/vmlinuz]"

Add a new Unified Kernel Image (UKI) boot entry

$ limine-entry-tool --add-uki "[kernel_name]" "[path/to/uki.efi]"

Remove a kernel boot entry and its associated files from the ESP

$ limine-entry-tool --remove "[kernel_name]"

Remove an entire OS entry by its name or machine ID

$ limine-entry-tool --remove-os "[OS_name|machine_id]"

Add an EFI boot entry for an alternative bootloader (e.g., Windows)

$ limine-entry-tool --add-efi "[EFI_entry_name]" "[path/to/loader.efi]"

SYNOPSIS

limine-entry-tool --option [arguments]

limine-entry-tool is a helper script for managing Limine bootloader entries on UEFI systems. It automates the process of adding, removing, and discovering boot entries in the Limine configuration.The tool can detect existing UEFI boot entries (including other operating systems like Windows) and add them to Limine's boot menu. It supports both traditional kernel/initramfs pairs and modern Unified Kernel Images (UKI).Boot entries are stored on the EFI System Partition (ESP), and the tool manages both the configuration and the actual kernel files. It is also used in the background by limine-mkinitcpio-hook to update boot entries when kernels are installed or removed.

PARAMETERS

--scan

Scan for active UEFI boot entries and add them to the Limine configuration.

--add name initramfs vmlinuz

Add a new kernel boot entry with the specified name, initramfs, and kernel file.

--add-uki name uki.efi

Add a Unified Kernel Image boot entry.

--remove name

Remove a kernel boot entry and its files from the EFI System Partition.

--remove-os name|machineid_

Remove an entire operating system entry by name or machine ID, leaving bootable files intact.

--add-efi name loader.efi

Add an EFI boot entry for another bootloader (chainloading).

CONFIGURATION

/etc/limine-entry-tool.conf

Configuration file for limine-entry-tool settings. Can optionally be copied to /etc/default/limine.

CAVEATS

Requires write access to the EFI System Partition. Changes to Limine configuration may require re-enrollment of the config hash if Secure Boot is enabled (see limine-enroll-config). The ESP must be mounted before running this tool.