By default Alpine uses Syslinux as bootloader. This page shows the basic steps you need to perform, if you for any reason want to switch bootloaders or apply some manual configuration.
If you want to switch from another bootloader back to Syslinux, or if you for some reason want to install Syslinux manually, the following steps are required.
apk add syslinux
If you're using GPT partitions, install the GPT MBR onto the drive you want to install the bootloader on (in this case
dd bs=440 count=1 conv=notrunc if=/usr/share/syslinux/gptmbr.bin of=/dev/sda
Or if you're using DOS partitions, install the DOS MBR instead:
dd bs=440 count=1 conv=notrunc if=/usr/share/syslinux/mbr.bin of=/dev/sda
Next install the required Syslinux binaries. Despite being called
extlinux, Syslinux supports booting from FAT12/16/32, NTFS, ext2/3/4, Btrfs, XFS, and UFS/FFS filesystems.
extlinux --install /boot
The configuration file is located in
Alpine ships with a script called
update-extlinux which automatically (re)generates this file, for example on updates to Syslinux.
The settings for this script can be found in
/etc/update-extlinux.conf, including the option to disable automatic overwriting of
You can also place additional menu entries in the
/etc/update-extlinux.d/ directory, e.g. for dual booting.
/mnt is a FAT32 partition of type EF00 and
/boot belongs to the rootfs created after running
mkdir -p /mnt/EFI/syslinux cp /usr/share/syslinux/efi64/* /mnt/EFI/syslinux/ cp /boot/extlinux.conf /mnt/EFI/syslinux/syslinux.cfg cp /boot/vmlinuz* /mnt/ cp /boot/initramfs* /mnt/
You may need to modify
/mnt/EFI/syslinux/syslinux.cfg to change the paths to absolute paths (just add a / in front of the vmlinuz/initramfs entries),
or copy the files to
/mnt/EFI/syslinux instead (XXX: untested).
To install GRUB in BIOS mode, (optionally) remove the Syslinux package and install the required GRUB packages:
apk del syslinux apk add grub grub-bios
For EFI, install Grub's EFI package instead. Note that
/boot has to be an EFI compatible filesystem like FAT32.
apk add grub-efi
Next install the MBR and GRUB binaries to disk for BIOS mode:
For EFI mode:
grub-install --target=x86_64-efi --efi-directory=/boot
GRUB ships with an automatic config generator, including some automatic detection of other operating systems installed on the device:
grub-mkconfig -o /boot/grub/grub.cfg
This script can be configured via the
See  for a list of available options.
Systemd-boot is the simple EFI bootloader part of the systemd project. It is also available in the Alpine Linux testing repository as a standalone component.
To install the systemd-boot, enable the testing repository, and install the
systemd-boot package. Then make sure the boot and EFI partitions are mounted as read-write and install the bootloader with
# apk add systemd-boot # bootctl install
If you are not sure if the bootloader was installed then
bootctl is-installed can be used to check, if it returns
yes then systemd-boot is installed.
Example configuration files for alpine are available on
Systemd-boot also provides a way to pass random-seed to the next boot, this can be enabled with
# bootctl random-seed
To prepare a proper boot entry for your operating system, one can copy the example alpine.conf to
/boot/loader/entries and edit to be appropriate for their system, including: changing the example root=UUID= to point to their root partition; changing rootfstype= to the filesystem of the root parition and adding options used in previous syslinux or grub entries.
# cp /usr/share/systemd/bootctl/alpine.conf /boot/loader/entries # vi /boot/loader/entries/alpine.conf
One can use the
bootctl list to see what entries are available, which one is default and more information about them.
systemd-boot package is updated then the bootloader installed needs to be updated as well:
# bootctl update
If for any reason you wish to not use systemd-boot anymore then the
bootctl binary also provides a command for easily removing the files that were installed with the install command:
# bootctl remove # apk del systemd-boot