Refind configuration

Documentation

official docs: configuration

http://www.rodsbooks.com/refind/configfile.html

Locations

/boot/EFI/refind/refind.conf	config
/boot/EFI/refind/themes/${theme}/*	theme files

Setup

refind-install  # replaces systemd-boot, automatically finds EFI stubs

You'll need to re-run refind-install on refind updates.
This will do it automatically.

# /etc/pacman.d/hooks/refind.hook
[Trigger]
Operation=Upgrade
Type=Package
Target=refind

[Action]
Description = Updating rEFInd on ESP
When=PostTransaction
Exec=/usr/bin/refind-install

Configuration

Common Settings

# /boot/EFI/refind/refind.conf
scan_delay 5    # wait 5s to scan for disks (helps if ex. windows not detected)
timeout 10      # boot after 10s unless a key is pressed
resolution max  # use max possible resolution

Kernel Options

First, generate a /boot/refind_linux.conf if it doesn't exist (it applies to all kernels in the same directory).

test -f /boot/refind_linux.conf || mkrlconf

Next, adjust the boot options you'd like within the subsection you'd like

# /boot/refind_linux.conf

"Boot with standard options"  "root=PARTUUID=${SOME_PARTUUID} rw rdblacklist=nouveau nomodeset systemd.unified_cgroup_hierarchy=0 ${YOUR_KERNEL_PARAMS}"
"Boot to single-user mode"    "root=PARTUUID=${SOME_PARTUUID} rw rdblacklist=nouveau nomodeset single ${YOUR_KERNEL_PARAMS}"
"Boot with minimal options"   "ro root=UUID=${SOME_PARTUUID} ${YOUR_KERNEL_PARAMS}"

Themes

# some nice themes
aura -A refind-theme-darkmini-git   # https://github.com/LightAir/darkmini
aura -A refind-theme-nord           # https://github.com/jaltuna/refind-theme-nord
aura -A refind-theme-regular-git    # https://github.com/bobafetthotmail/refind-theme-regular

# /boot/EFI/refind/refind.conf

# ...at end of file...

include themes/darkmini/theme.conf
banner themes/darkmini/bg/background.png