REFInd - Revision history

John3-16: 1. rEFInd described upstream as a boot manager; minor changes to that effect; 2. Added various template codes; 3. Style/grammar amendments

2025-09-11T02:37:45Z

1. rEFInd described upstream as a boot manager; minor changes to that effect; 2. Added various template codes; 3. Style/grammar amendments

← Older revision		Revision as of 02:37, 11 September 2025
Line 57:		Line 57:
	=== Manual configuration ===		=== Manual configuration ===

	There is also a second ~~config~~ file, {{Path\|refind.conf}}, which is located inside the EFI partition. The ~~config~~ file is self-explanatory and has to be manually edited. Please refer to the [https://www.rodsbooks.com/refind/configfile.html rEFInd website] for additional information.		There is also a second configuration file, {{Path\|refind.conf}}, which is located inside the EFI partition. The configuration file is self-explanatory and has to be manually edited. Please refer to the [https://www.rodsbooks.com/refind/configfile.html rEFInd website] for additional information.
	<!--		<!--
	During Installation a (default) boot menu line can be configured with Alpine's default boot parameters. Assuming the bootable partition is mounted at {{path\|/media/sdXY}} it can be done like this (at time of writing):		During Installation a (default) boot menu line can be configured with Alpine's default boot parameters. Assuming the bootable partition is mounted at {{path\|/media/sdXY}} it can be done like this (at time of writing):
Line 112:		Line 112:
	# PARTUUID not working for alpine		# PARTUUID not working for alpine
	}		}
	</nowiki> ~~/boot/EFI/refind/icons//boot/EFI/refind/icons/~~		</nowiki>
	}}		}}

John3-16: 1. rEFInd described upstream as a boot manager; minor changes to that effect; 2. Added various template codes; 3. style/grammar amendments

2025-09-11T02:12:40Z

1. rEFInd described upstream as a boot manager; minor changes to that effect; 2. Added various template codes; 3. style/grammar amendments

Show changes

Prabuanand: few changes to make page consistent

2025-09-02T11:28:07Z

few changes to make page consistent

← Older revision		Revision as of 11:28, 2 September 2025
Line 52:		Line 52:
	=== Manual configuration ===		=== Manual configuration ===

	~~And~~ a ~~first~~ (default) boot menu line ~~needs to~~ be configured with Alpine's default boot parameters. Assuming the bootable partition is mounted at {{path\|/media/sdXY}} it can be done like this (at time of writing):		There is also a second config file, '''refind.conf''' which is located inside the EFI partition. The config file is self-explanatory and has to be manually edited. Refer [https://www.rodsbooks.com/refind/configfile.html refind website] for additional information.
			<!--
			During Installation a (default) boot menu line can be configured with Alpine's default boot parameters. Assuming the bootable partition is mounted at {{path\|/media/sdXY}} it can be done like this (at time of writing):
	{{cmd\|<nowiki># echo '"Alpine" "modules=loop,squashfs,sd-mod,usb-storage quiet initrd=\boot\intel-ucode.img initrd=\boot\amd-ucode.img initrd=\boot\initramfs-lts"' > /media/sdXY/boot/refind_linux.conf</nowiki>}}		{{cmd\|<nowiki># echo '"Alpine" "modules=loop,squashfs,sd-mod,usb-storage quiet initrd=\boot\intel-ucode.img initrd=\boot\amd-ucode.img initrd=\boot\initramfs-lts"' > /media/sdXY/boot/refind_linux.conf</nowiki>}}
			-->
	{{Note\|At the time of writing, it was still needed to use backslashes in the .conf file.<br>		{{Note\|At the time of writing, it was still needed to use backslashes in the .conf file.<br>
	The path in the config file needs to be relative to the partition that the kernel resides on. If {{path\|/boot}} resides on its own separate partition, then <code>\boot</code> needs to be removed from the paths.}}		The path in the config file needs to be relative to the partition that the kernel resides on. If {{path\|/boot}} resides on its own separate partition, then <code>\boot</code> needs to be removed from the paths.}}

	There is also a second config file, '''refind.conf''' which is located inside the EFI partition. The config file is self-explanatory and has to be manually edited. Refer [https://www.rodsbooks.com/refind/configfile.html refind website] for additional information.

	The below instructions assume esp partition is mounted as shown:{{cat\|/etc/fstab\|<nowiki>...		The below instructions assume esp partition is mounted as shown:{{cat\|/etc/fstab\|<nowiki>...
Line 69:		Line 69:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! EFI Mount !! Kernel Location !! ~~volume~~ !! loader path		! EFI Mount !! Kernel Location !! Filesystem Label !! loader path
	\|-		\|-
	\| /boot/efi or /efi \|\| Root filesystem \|\| ROOT \|\| /boot/vmlinuz-lts		\| /boot/efi or /efi \|\| Root filesystem \|\| ROOT \|\| /boot/vmlinuz-lts
Line 97:		Line 97:
	<nowiki>menuentry "Alpine Linux" {		<nowiki>menuentry "Alpine Linux" {
	icon /EFI/refind/icons/os_alpine.png		icon /EFI/refind/icons/os_alpine.png
	volume ~~BTRFSVOL~~		volume ROOT
	loader @/boot/vmlinuz-lts		loader @/boot/vmlinuz-lts
	initrd @/boot/initramfs-lts		initrd @/boot/initramfs-lts

Prabuanand: clarified the volume label and addressed all /boot locations

2025-09-02T11:11:08Z

clarified the volume label and addressed all /boot locations

← Older revision		Revision as of 11:11, 2 September 2025
Line 64:		Line 64:
	...</nowiki>}}		...</nowiki>}}
	If your setup is different from above, adjust the path in below files accordingly.		If your setup is different from above, adjust the path in below files accordingly.

			{{Tip\|The '''Volume''' directive tells rEFInd which filesystem contains the kernel/initrd files. This could be the EFI partition, a separate /boot partition, or even the root filesystem itself. Use the appropriate partition's [[Filesystems#Filesystem_labels\|filesystem label]] here.}}

			{\| class="wikitable"
			\|-
			! EFI Mount !! Kernel Location !! volume !! loader path
			\|-
			\| /boot/efi or /efi \|\| Root filesystem \|\| ROOT \|\| /boot/vmlinuz-lts
			\|-
			\| /boot \|\| EFI partition \|\| BOOT \|\| /vmlinuz-lts
			\|}

	For default alpine [[Installation#System_Disk_Mode\|sys]] mode installation, a sample refind.conf to [[Dualbooting\|dual boot]] Alpine Linux and windows will be: {{Cat\|/boot/efi/EFI/refind/refind.conf\|<nowiki>timeout 20		For default alpine [[Installation#System_Disk_Mode\|sys]] mode installation, a sample refind.conf to [[Dualbooting\|dual boot]] Alpine Linux and windows will be: {{Cat\|/boot/efi/EFI/refind/refind.conf\|<nowiki>timeout 20
Line 87:		Line 98:
	icon /EFI/refind/icons/os_alpine.png		icon /EFI/refind/icons/os_alpine.png
	volume BTRFSVOL		volume BTRFSVOL
	loader @~~alpine~~/boot/vmlinuz-lts		loader @/boot/vmlinuz-lts
	initrd @~~alpine~~/boot/initramfs-lts		initrd @/boot/initramfs-lts
	options "root=UUID=823a3283-30a7-4fef-b50b-8a2230c71b5b rw rootflags=subvol=@~~alpine~~ rootfstype=btrfs"		options "root=UUID=823a3283-30a7-4fef-b50b-8a2230c71b5b rw rootflags=subvol=@ rootfstype=btrfs"
	# PARTUUID not working for alpine		# PARTUUID not working for alpine
	}		}

Prabuanand: fixed error message

2025-06-26T05:55:01Z

fixed error message

← Older revision		Revision as of 05:55, 26 June 2025
Line 99:		Line 99:
	== Troubleshooting ==		== Troubleshooting ==

	=== ~~invalid~~ loader file ===		=== Invalid loader file ===

	{{Cmd\|<nowiki>starting vmlinux-lts		{{Cmd\|<nowiki>starting vmlinux-lts
	using load options options "root=UUID=823a3283-30a7-4fef-b50b-8a2230c71b5b rw rootflags=subvol=@alpine rootfstype=btrfs"		using load options options 'root=UUID=823a3283-30a7-4fef-b50b-8a2230c71b5b rw rootflags=subvol=@alpine rootfstype=btrfs initrd=@alpine\boot\initramfs-lts'
	~~invalid~~ loader file		Invalid loader file!
	Error:Not found while loading vmlinuz-lts</nowiki>}}		Error:Not found while loading vmlinuz-lts</nowiki>}}

	If [[Btrfs]] filesystem is used, the above error is caused by missing drivers. Ensure that driver file {{ic\|btrfs_x64.efi}} is copied from {{Path\|/usr/share/refind/drivers_x86_64/btrfs_x64.efi}} to the appropriate folder in efi partition for e.g {{Path\|/boot/efi/EFI/refind/drivers_x64/}}		If [[Btrfs]] filesystem is used, the above error is caused by missing drivers. Ensure that driver file {{ic\|btrfs_x64.efi}} is copied from {{Path\|/usr/share/refind/drivers_x86_64/btrfs_x64.efi}} to the appropriate folder in efi partition for e.g {{Path\|/boot/efi/EFI/refind/drivers_x64/}}

	==See also ==		==See also ==

Prabuanand: added Troubleshooting information

2025-06-26T05:51:09Z

added Troubleshooting information

← Older revision		Revision as of 05:51, 26 June 2025
Line 99:		Line 99:
	== Troubleshooting ==		== Troubleshooting ==

			=== invalid loader file ===

			{{Cmd\|<nowiki>starting vmlinux-lts
			using load options options "root=UUID=823a3283-30a7-4fef-b50b-8a2230c71b5b rw rootflags=subvol=@alpine rootfstype=btrfs"
			invalid loader file
			Error:Not found while loading vmlinuz-lts</nowiki>}}

			If [[Btrfs]] filesystem is used, the above error is caused by missing drivers. Ensure that driver file {{ic\|btrfs_x64.efi}} is copied from {{Path\|/usr/share/refind/drivers_x86_64/btrfs_x64.efi}} to the appropriate folder in efi partition for e.g {{Path\|/boot/efi/EFI/refind/drivers_x64/}}

	==See also ==		==See also ==

Prabuanand: fixed displayname

2025-06-26T05:43:00Z

fixed displayname

← Older revision		Revision as of 05:43, 26 June 2025
Line 1:		Line 1:
	[https://www.rodsbooks.com/refind/ rEFInd] provides a graphical boot menu for [[UEFI]] systems, that allows to boot operating systems that are found on the available partitions.		{{DISPLAYTITLE:rEFInd}}[https://www.rodsbooks.com/refind/ rEFInd] provides a graphical boot menu for [[UEFI]] systems, that allows to boot operating systems that are found on the available partitions.

	== Installation ==		== Installation ==

Prabuanand: Prabuanand moved page Refind to REFInd: to fix the name of page to align with the actual name

2025-06-26T05:42:20Z

Prabuanand moved page Refind to REFInd: to fix the name of page to align with the actual name

← Older revision	Revision as of 05:42, 26 June 2025
(No difference)

Prabuanand: fixed typo

2025-06-26T05:41:36Z

fixed typo

← Older revision		Revision as of 05:41, 26 June 2025
Line 1:		Line 1:
	~~{{DISPLAYTITLE:rEFInd}}~~[https://www.rodsbooks.com/refind/ rEFInd] provides a graphical boot menu for [[UEFI]] systems, that allows to boot operating systems that are found on the available partitions.		[https://www.rodsbooks.com/refind/ rEFInd] provides a graphical boot menu for [[UEFI]] systems, that allows to boot operating systems that are found on the available partitions.

	== Installation ==		== Installation ==
Line 103:		Line 103:
	* [[Bootloaders]]		* [[Bootloaders]]
	* [https://www.rodsbooks.com/refind/configfile.html Official configuration guide]		* [https://www.rodsbooks.com/refind/configfile.html Official configuration guide]
	* [
	[[Category:Installation]]		[[Category:Installation]]
	[[Category:Booting]]		[[Category:Booting]]

Prabuanand: moved content from Bootloader

2025-06-26T05:31:49Z

moved content from Bootloader

New page

{{DISPLAYTITLE:rEFInd}}[https://www.rodsbooks.com/refind/ rEFInd] provides a graphical boot menu for [[UEFI]] systems, that allows to boot operating systems that are found on the available partitions.

== Installation ==

As of now, {{pkg|refind}} is available in the [[Repositories#Testing|testing]] repository. It can be safely installed by following the [[Repositories#Using_testing_repository|guidelines]].

The below command installs the alpine-linux rEFInd package:
{{cmd|# apk add refind@testing }}

== Configuration ==

rEFInd's refind-install script creates a sample file {{Path|/boot/refind_linux.conf}}.
{{cmd| # refind-install}}


The above steps should be sufficient for most cases to start using rEFInd as boot loader.
A sample {{Path|/boot/refind_linux.conf}} from rEFInd website for a system with ext4 filesystem is given below:
{{Cat|/boot/refind_linux.conf|<nowiki>"Boot with standard options" "ro root=UUID=084f544a-7559-4d4b-938a-b920f59edc7e splash=silent quiet showopts "
"Boot to single-user mode" "ro root=UUID=084f544a-7559-4d4b-938a-b920f59edc7e splash=silent quiet showopts single"
"Boot with minimal options" "ro root=UUID=084f544a-7559-4d4b-938a-b920f59edc7e"
# This line is a comment</nowiki>}}

This sample file defines three entries:
* The first entry uses options derived from the contents of {{Path|/proc/cmdline}} when the script was run, unless the script was run from an emergency system, in which case refind-install tries to translate from options in {{Path|/etc/default/grub}}.
* The second entry provides the same boot options as the first, but adds single, which causes most distributions to boot into a single-user maintenance mode.
* The final entry subtracts most options from the list, leaving only ro root=rootfs, where rootfs is the identified root (/) filesystem. This option may not be bootable on some systems that need unusual options, but if it does boot, it will normally do so with verbose startup messages, which can be helpful when debugging boot problems.

Given below is a sample {{Path|/boot/refind_linux.conf}} created automatically by rEFInd for a system with [[Btrfs]] filesystem whose layout is given further below as <Code>blkid</Code> output:
{{Cat|/boot/refind_linux.conf|<nowiki>"Boot with standard options" "root=LABEL=_SYS0_ modules=sd-mod,usb-storage,btrfs rootflags=subvol=@ resume=LABEL=_SWAP_ ro quiet"
"Boot to single-user mode" "root=LABEL=_SYS0_ modules=sd-mod,usb-storage,btrfs rootflags=subvol=@ resume=LABEL=_SWAP_ ro quiet single"
"Boot with minimal options" "ro root=UUID=aafbf6b0-7d54-4222-a3dd-a8f45c0ac607"</nowiki>}}

Output of <Code>blkid</Code> from [[Busybox]] is given below.
<Pre>
/dev/sda4: LABEL="_SWAP_" UUID="33899521-599f-458e-9bfe-f4b59254eb7c" TYPE="swap"
/dev/sda3: LABEL="_SYS0_" UUID="aafbf6b0-7d54-4222-a3dd-a8f45c0ac607" TYPE="btrfs"
/dev/sda1: LABEL="_BOOT_" UUID="6771-DB5C" TYPE="vfat"
</Pre>
The single-user mode and minimal options does not work in Alpine Linux for [[Btrfs]] filesystem as per user u/Xerotras in https://redd.it/1hbog74

{{Note|The {{pkg|refind}} utility currently does not have Alpine Linux icon file. You can place the [[Media:Os alpine.png| icon file]] in {{Path|/boot/efi/EFI/refind/icons/}} or {{Path|/boot/EFI/refind/icons/}} folder.}}

[[File:Os alpine.png|thumb|right|100px|alt=Alpine linux icon file for refind|icon file]]
Proceed to [[#Manual configuration|Manual configuration]] only if rebooting did not result in rEFInd appearing as boot loader.

=== Manual configuration ===

And a first (default) boot menu line needs to be configured with Alpine's default boot parameters. Assuming the bootable partition is mounted at {{path|/media/sdXY}} it can be done like this (at time of writing):
{{cmd|<nowiki># echo '"Alpine" "modules=loop,squashfs,sd-mod,usb-storage quiet initrd=\boot\intel-ucode.img initrd=\boot\amd-ucode.img initrd=\boot\initramfs-lts"' > /media/sdXY/boot/refind_linux.conf</nowiki>}}

{{Note|At the time of writing, it was still needed to use backslashes in the .conf file.<br>
The path in the config file needs to be relative to the partition that the kernel resides on. If {{path|/boot}} resides on its own separate partition, then <code>\boot</code> needs to be removed from the paths.}}

There is also a second config file, '''refind.conf''' which is located inside the EFI partition. The config file is self-explanatory and has to be manually edited. Refer [https://www.rodsbooks.com/refind/configfile.html refind website] for additional information.

The below instructions assume esp partition is mounted as shown:{{cat|/etc/fstab|<nowiki>...
UUID=ABCD-1234 /boot/efi vfat rw,relatime,fmask=0022,dmask=0022,codepage=437,iocharset=utf8,shortname=mixed,errors=remount-ro 0 2
...</nowiki>}}
If your setup is different from above, adjust the path in below files accordingly.

For default alpine [[Installation#System_Disk_Mode|sys]] mode installation, a sample refind.conf to [[Dualbooting|dual boot]] Alpine Linux and windows will be: {{Cat|/boot/efi/EFI/refind/refind.conf|<nowiki>timeout 20
resolution 1920 1080
use_graphics_for windows,linux

menuentry "Windows" {
loader /EFI/Microsoft/Boot/bootmgfw.efi
icon /EFI/refind/icons/os_win.png
}
menuentry "Alpine Linux" {
icon /EFI/refind/icons/os_alpine.png
volume ROOT
loader /boot/vmlinuz-lts
initrd /boot/initramfs-lts
options "root=UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx rw"
} </nowiki> }}

If you use [[btrfs]] filesystem, for the above {{Path|/etc/fstab}} setup, the necessary boot entry for Alpine Linux is as follows:

{{Cat|/boot/efi/EFI/refind/refind.conf|
<nowiki>menuentry "Alpine Linux" {
icon /EFI/refind/icons/os_alpine.png
volume BTRFSVOL
loader @alpine/boot/vmlinuz-lts
initrd @alpine/boot/initramfs-lts
options "root=UUID=823a3283-30a7-4fef-b50b-8a2230c71b5b rw rootflags=subvol=@alpine rootfstype=btrfs"
# PARTUUID not working for alpine
}
</nowiki>
}}

{{Tip|If the above configuration is working perfectly,there is no need for other bootloaders and they can be safely removed.}}

== Troubleshooting ==

==See also ==

* [[Bootloaders]]
* [https://www.rodsbooks.com/refind/configfile.html Official configuration guide]
* [
[[Category:Installation]]
[[Category:Booting]]