https://wiki.alpinelinux.org/w/api.php?action=feedcontributions&feedformat=atom&user=MraAlpine Linux - User contributions [en]2026-04-25T21:28:59ZUser contributionsMediaWiki 1.40.0https://wiki.alpinelinux.org/w/index.php?title=Create_UEFI_boot_USB&diff=13686Create UEFI boot USB2017-07-12T16:28:57Z<p>Mra: Update file names and correct paths</p>
<hr />
<div>This article explains how to create an UEFI boot USB with parted and gummiboot.<br />
<br />
In this example we will use {{Path|/dev/sdX}}. This will be different depending on your system.<br />
<br />
== Create GPT boot partition ==<br />
<br />
Install {{Pkg|parted}}<br />
{{Cmd | apk add parted }}<br />
<br />
Create a single UEFI boot partitions.<br />
{{warning| this will erase all content of your {{Path|/dev/sdX}}. Make sure that you use correct device}}<br />
<br />
{{Cmd | parted --script /dev/sdX mklabel gpt}}<br />
{{Cmd | parted --script --align{{=}}optimal /dev/sdX mkpart ESP fat32 1MiB 512MiB }}<br />
{{Cmd | parted --script /dev/sdX set 1 boot on }}<br />
<br />
== Create fat32 filesystem ==<br />
<br />
Create a fat32 system with the name `Alpine`.<br />
<br />
{{Cmd | mkfs.vfat -n Alpine /dev/sdX1 }}<br />
<br />
<br />
== Copy content of ISO image to filesystem ==<br />
<br />
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.<br />
<br />
{{Cmd | mount -t vfat /dev/sdX1 /mnt }}<br />
{{Cmd | cd /mnt && uniso < /path/to/alpine-3.4.0-x86_64.iso }}<br />
<br />
== Copy gummiboot efi binary ==<br />
<br />
UEFI will look for a {{Path|EFI/bootx64.efi}} as a fallback efi loader. We copy {{Path|gummibootx64.efi}} to this location.<br />
<br />
{{Cmd | mkdir -p /mnt/EFI/Boot }}<br />
{{Cmd | apk add gummiboot }}<br />
{{Cmd | cp /usr/lib/gummiboot/gummibootx64.efi /mnt/EFI/Boot/bootx64.efi }}<br />
<br />
<br />
== Create configuration files for boot loader ==<br />
<br />
We need create some configuration files for gummiboot.<br />
{{Cmd | mkdir -p loader/entries }}<br />
<br />
{{Cat | loader/loader.conf |default alpine<br />
timeout 4<br />
}}<br />
<br />
The options are taken from {{Path|boot/syslinux/syslinux.cfg}}<br />
<br />
{{Cat | loader/entries/alpine.conf |title Alpine Linux<br />
linux /boot/vmlinuz-hardened<br />
initrd /boot/initramfs-hardened<br />
options modloop{{=}}/boot/modloop-hardened modules{{=}}loop,squashfs,sd-mod,usb-storage quiet<br />
}}<br />
<br />
Finally umount the disk<br />
{{Cmd | cd ~ && umount /mnt}}</div>Mra