web/limine.md
2024-08-04 00:42:34 +02:00

3.9 KiB
Raw Permalink Blame History

TO BE REMOVED BY NEXT RELEASE >8.0.0

NOTE: this is under construction, several discrepancies, missing explanations, and

clarifications have been reported and it will soon be edited and corrected - our apologies but documentation on limine is both scarce and contradictory when and where it is found. Best source we see at the moment is gentoo, arch is very contradictory to its uefi /efi partitioning scheme, limine will NOT work that way.

We have tried to make it work mounting the esp flagged FAT partition to /boot/efi but have not been able to get it to boot. Latest major release shows much renaming of things unnecesseraly, still undocumented as to the why and its effects, dropping gz support ..

This is just another piece of software that attempts to reaarrange your system just so you can make it work. What is the problem it is solving? Having 1 config file for booting?

Back to the top joborun wiki page

*this document is a contribution by joborun community member: Kerry Kappell (kerry@klouded.org)*

Installing Limine on a new BIOS installation

Additonal steps to a fresh installation:

Limine works with either a DOS or an GPT partion table. GPT is recommended. A FAT partion is required. A modern trend is to make the FAT partion the /boot directory so make the size at least 256M or 512M.

mkfs.fat -F 32 /dev/sdXY (for example and where X = disk letter and Y = the partiton number)

mkdir -p /mnt/boot/efi

mount /dev/sdXY /boot/efi

pacman -Syu linux-lts limine

mv /boot/efi/limine/limine.conf /boot/efi/limine/limine.conf.jobopkg

nano /boot/efi/limine/limine.conf

and add:

TIMEOUT=5

:Joborun Linux-LTS

PROTOCOL=linux

KERNEL_PATH=boot:///vmlinuz-linux-lts

CMDLINE=root=UUID=xxxxx-xxxxx ro net.ifnames=0 ipv6.disable=1 init=/usr/bin/runit-init

MODULE_PATH=boot:///{amd,intel}-ucode.img

MODULE_PATH=boot:///initramfs-linux-lts.img

(Your UUID can be found by cat /etc/fstab or genfstab -U / or ls -lh /dev/disk/by-uuid )

  1. limine bios-install /dev/sdX (limine-bios.sys has already been added to /boot/limine/)

Installing Limine on a new UEFI installation

Step 0: The following command should be run outside and inside the chroot: mount -t efivarfs efivarfs /sys/firmware/efi/efivars

(if the host was booted from an efi system)

Steps 1 through 8 apply to a new UEFI installation as well but steps 1-5 are very familiar to UEFI setups and dont really need instructions here.

pkg -S efibootmgr

mount -t efivarfs efivarfs /sys/firmware/efi/efivars

mkdir -p /boot/efi/EFI/BOOT

cp /usr/share/limine/BOOTX64.EFI /boot/efi/EFI/BOOT/

efibootmgr --create --disk /dev/sdX --part Y --loader EFI\BOOT\BOOTX64.EFI --label Limine Boot Manager --unicode

where X and Y need to be replaced with your disk letter and partition number. Note that backslashes are used here instead of forward slashes. Also note that /boot or \boot is omitted as it is cover by the disk and partition info.


Of interest, both BIOS and UEFI setups can be done on the UEFI installation and now one has a dual boot setup!


Installing limine on an existing system with GRUB can also be done but limine does not replace or reorder the efibootmgr entries.

References: