Create UEFI boot USB - Revision history

Prabuanand: Added obsolete notice and removed the categories so that this page does not get listed

2024-12-30T03:36:15Z

Added obsolete notice and removed the categories so that this page does not get listed

← Older revision		Revision as of 03:36, 30 December 2024
Line 1:		Line 1:
	{{~~Note~~ \| These manual steps aren't required anymore, as the latest release images can just be written to an USB like normal and will support UEFI booting}}		{{Obsolete \| These manual steps aren't required anymore, as the latest release images can just be written to an USB like normal and will support UEFI booting}}

	This article explains how to create an UEFI boot USB with parted and gummiboot.		This article explains how to create an UEFI boot USB with parted and gummiboot.
Line 34:		Line 34:
	Finally umount the disk		Finally umount the disk
	{{Cmd \| cd ~ && umount /mnt}}		{{Cmd \| cd ~ && umount /mnt}}

	~~[[Category:Installation]] [[Category:UEFI]]~~

WhyNotHugo: Add category UEFI

2023-11-07T10:09:40Z

Add category UEFI

← Older revision		Revision as of 10:09, 7 November 2023
Line 35:		Line 35:
	{{Cmd \| cd ~ && umount /mnt}}		{{Cmd \| cd ~ && umount /mnt}}

	[[Category:Installation]]		[[Category:Installation]] [[Category:UEFI]]

PureTryOut at 14:49, 4 July 2019

2019-07-04T14:49:43Z

← Older revision		Revision as of 14:49, 4 July 2019
Line 1:		Line 1:
			{{Note \| These manual steps aren't required anymore, as the latest release images can just be written to an USB like normal and will support UEFI booting}}

	This article explains how to create an UEFI boot USB with parted and gummiboot.		This article explains how to create an UEFI boot USB with parted and gummiboot.

Emolitor at 13:46, 30 December 2018

2018-12-30T13:46:51Z

← Older revision		Revision as of 13:46, 30 December 2018
Line 27:		Line 27:
	{{Cmd \| mount -t vfat /dev/sdX1 /mnt		{{Cmd \| mount -t vfat /dev/sdX1 /mnt
	cd /mnt		cd /mnt
	uniso < /path/to/alpine-3.4.0-x86_64.iso }}		uniso < /path/to/alpine-3.8.2-x86_64.iso }}

	== Unmount the partition ==		== Unmount the partition ==

Emolitor: Undo revision 15618 by Emolitor (talk)

2018-12-30T13:46:03Z

Undo revision 15618 by Emolitor (talk)

@@ Line 26: / Line 26: @@
 {{Cmd | mount -t vfat /dev/sdX1 /mnt
-  cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}
+  cd /mnt
+ uniso < /path/to/alpine-3.4.0-x86_64.iso }}
 Finally umount the disk
 {{Cmd | cd ~ && umount /mnt}}
 [[Category:Installation]]

Emolitor at 13:35, 30 December 2018

2018-12-30T13:35:56Z

@@ Line 26: / Line 26: @@
 {{Cmd | mount -t vfat /dev/sdX1 /mnt
-  cd /mnt
+  cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}
- uniso < /path/to/alpine-3.4.0-x86_64.iso }}
 Finally umount the disk
 {{Cmd | cd ~ && umount /mnt}}
 [[Category:Installation]]

Emolitor: Update instructions for modern Alpine images which already include grub-efi

2018-12-30T13:35:41Z

Update instructions for modern Alpine images which already include grub-efi

← Older revision		Revision as of 13:35, 30 December 2018
Line 9:		Line 9:

	Create a single UEFI boot partitions.		Create a single UEFI boot partitions.
	{{warning\| ~~this~~ will erase all content of your {{Path\|/dev/sdX}}. Make sure that you use correct device}}		{{warning\| This will erase all content of your {{Path\|/dev/sdX}}. Make sure that you use correct device.}}

	{{Cmd \| parted --script /dev/sdX mklabel gpt		{{Cmd \| parted --script /dev/sdX mklabel gpt
	parted --script --align{{=}}optimal /dev/sdX mkpart ESP fat32 1MiB ~~512MiB~~		parted --script --align{{=}}optimal /dev/sdX mkpart ESP fat32 1MiB 100%
	parted --script /dev/sdX set 1 boot on }}		parted --script /dev/sdX set 1 boot on }}

Line 19:		Line 19:
	Create a fat32 system with the name `Alpine`.		Create a fat32 system with the name `Alpine`.

	{{Cmd \| mkfs.vfat -n ~~Alpine~~ /dev/sdX1 }}		{{Cmd \| mkfs.vfat -n ALPINE /dev/sdX1 }}

	== Copy content of ISO image to filesystem ==		== Copy content of ISO image to filesystem ==
Line 26:		Line 26:

	{{Cmd \| mount -t vfat /dev/sdX1 /mnt		{{Cmd \| mount -t vfat /dev/sdX1 /mnt
	cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}		cd /mnt
			uniso < /path/to/alpine-3.4.0-x86_64.iso }}
	~~== Copy gummiboot efi binary ==~~

	~~{{note\| Gummiboot has been forked in Alpine Linux since it has been [https://www.freedesktop.org/wiki/Software/systemd/systemd-boot/ consumed by systemd upstream].}}~~

	~~UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|gummibootx64.efi}} to this location.~~

	~~{{Cmd \| mkdir -p /mnt/EFI/Boot~~
	~~apk add gummiboot~~
	~~cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}~~

	~~== Create configuration files for boot loader ==~~

	~~We need create some configuration files for gummiboot.~~
	~~{{Cmd \| mkdir -p loader/entries }}~~

	~~{{Cat \| loader/loader.conf \|default alpine~~
	~~timeout 4~~
	}}

	~~The options are taken from {{Path\|boot/syslinux/syslinux.cfg}}~~

	~~{{Cat \| loader/entries/alpine.conf \|title Alpine Linux~~
	~~linux /boot/vmlinuz-hardened~~
	~~initrd /boot/initramfs-hardened~~
	~~options modloop{{=}}/boot/modloop-hardened modules{{=}}loop,squashfs,sd-mod,usb-storage quiet~~
	}}

			== Unmount the partition ==
	Finally umount the disk		Finally umount the disk
	{{Cmd \| cd ~ && umount /mnt}}		{{Cmd \| cd ~ && umount /mnt}}

	[[Category:Installation]]		[[Category:Installation]]

Mcrute: Fix up command blocks

2018-04-29T19:18:56Z

Fix up command blocks

OxR463: /* Copy gummiboot efi binary */

2017-12-12T15:37:01Z

Copy gummiboot efi binary

← Older revision		Revision as of 15:37, 12 December 2017
Line 30:		Line 30:

	== Copy gummiboot efi binary ==		== Copy gummiboot efi binary ==

			{{note\| Gummiboot has been forked in Alpine Linux since it has been [https://www.freedesktop.org/wiki/Software/systemd/systemd-boot/ consumed by systemd upstream].}}

	UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|gummibootx64.efi}} to this location.		UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|gummibootx64.efi}} to this location.
Line 36:		Line 38:
	{{Cmd \| apk add gummiboot }}		{{Cmd \| apk add gummiboot }}
	{{Cmd \| cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}		{{Cmd \| cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}


	== Create configuration files for boot loader ==		== Create configuration files for boot loader ==

OxR463: Undo revision 14016 by OxR463 (talk)

2017-10-03T19:20:53Z

Undo revision 14016 by OxR463 (talk)

← Older revision		Revision as of 19:20, 3 October 2017
Line 29:		Line 29:
	{{Cmd \| cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}		{{Cmd \| cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}

	== ~~Create~~ efi binary ==		== Copy gummiboot efi binary ==

	UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|~~bootx64~~.efi}} to this location.		UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|gummibootx64.efi}} to this location.

	{{Cmd \| mkdir -p /mnt/EFI/Boot }}		{{Cmd \| mkdir -p /mnt/EFI/Boot }}
	{{Cmd \| apk add ~~grub-efi~~ }}		{{Cmd \| apk add gummiboot }}
	{{Cmd \| ~~grub-install --target=x86_64-efi --~~efi~~-directory=~~/mnt/EFI/Boot/ }}		{{Cmd \| cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}


	== Create configuration files for boot loader ==		== Create configuration files for boot loader ==

← Older revision		Revision as of 19:20, 3 October 2017
Line 29:		Line 29:
	{{Cmd \| cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}		{{Cmd \| cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}

	== ~~Create~~ efi binary ==		== Copy gummiboot efi binary ==

	UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|~~bootx64~~.efi}} to this location.		UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|gummibootx64.efi}} to this location.

	{{Cmd \| mkdir -p /mnt/EFI/Boot }}		{{Cmd \| mkdir -p /mnt/EFI/Boot }}
	{{Cmd \| apk add ~~grub-efi~~ }}		{{Cmd \| apk add gummiboot }}
	{{Cmd \| ~~grub-install --target=x86_64-efi --~~efi~~-directory=~~/mnt/EFI/Boot/ }}		{{Cmd \| cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}


	== Create configuration files for boot loader ==		== Create configuration files for boot loader ==

← Older revision		Revision as of 19:18, 29 April 2018
Line 11:		Line 11:
	{{warning\| this will erase all content of your {{Path\|/dev/sdX}}. Make sure that you use correct device}}		{{warning\| this will erase all content of your {{Path\|/dev/sdX}}. Make sure that you use correct device}}

	{{Cmd \| parted --script /dev/sdX mklabel gpt}}		{{Cmd \| parted --script /dev/sdX mklabel gpt
	~~{{Cmd \|~~ parted --script --align{{=}}optimal /dev/sdX mkpart ESP fat32 1MiB 512MiB }}		parted --script --align{{=}}optimal /dev/sdX mkpart ESP fat32 1MiB 512MiB
	~~{{Cmd \|~~ parted --script /dev/sdX set 1 boot on }}		parted --script /dev/sdX set 1 boot on }}

	== Create fat32 filesystem ==		== Create fat32 filesystem ==
Line 20:		Line 20:

	{{Cmd \| mkfs.vfat -n Alpine /dev/sdX1 }}		{{Cmd \| mkfs.vfat -n Alpine /dev/sdX1 }}


	== Copy content of ISO image to filesystem ==		== Copy content of ISO image to filesystem ==
Line 26:		Line 25:
	It is possible to mount the iso image and copy files with {{codeline\|cp}} or {{codeline\|rsync}} and it is also possible to use {{codeline\|7z}} to extract content from the iso. In this example I will use the {{codeline\|uniso}} utility from {{Pkg\|alpine-conf}} package.		It is possible to mount the iso image and copy files with {{codeline\|cp}} or {{codeline\|rsync}} and it is also possible to use {{codeline\|7z}} to extract content from the iso. In this example I will use the {{codeline\|uniso}} utility from {{Pkg\|alpine-conf}} package.

	{{Cmd \| mount -t vfat /dev/sdX1 /mnt }}		{{Cmd \| mount -t vfat /dev/sdX1 /mnt
	~~{{Cmd \|~~ cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}		cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}

	== Copy gummiboot efi binary ==		== Copy gummiboot efi binary ==
Line 35:		Line 34:
	UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|gummibootx64.efi}} to this location.		UEFI will look for a {{Path\|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path\|gummibootx64.efi}} to this location.

	{{Cmd \| mkdir -p /mnt/EFI/Boot }}		{{Cmd \| mkdir -p /mnt/EFI/Boot
	~~{{Cmd \|~~ apk add gummiboot }}		apk add gummiboot
	~~{{Cmd \|~~ cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}		cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}

	== Create configuration files for boot loader ==		== Create configuration files for boot loader ==