Linux guides

Return to previous index

NOTE: This guide pertains to x86 hosts, and does not cover supported CrOS/ARM chromebooks. For ARM targets, you should refer to u-boot documentation.

This page is useful for those who wish to use the GRUB GRUB payload directly. If you’re using SeaBIOS, the boot process will work similarly to traditional BIOS systems; refer to the SeaBIOS documentation on

Linux is generally assumed, especially for Libreboot development, but Libreboot also works quite nicely with BSD systems.

Useful links

Refer to the following pages:


Libreboot does not support switching VGA modes, when coreboot’s libgfxinit is used on Intel GPUs. Many distros will install GRUB, which Libreboot then finds and executes, if running SeaBIOS payload; if using GRUB, just the distro’s grub.cfg file is loaded instead, by Libreboot’s own GRUB in flash.

Libreboot GRUB boots in text mode or uses the coreboot framebuffer. Anyway, set GRUB_TERMINAL=console in GRUB and you should be fine. This avoids GRUB, the one provided by your distro, switching video modes.

In Debian for example (steps largely the same on other distros):

Edit /etc/default/grub as root, and uncomment or add the line:


Then still as root, do these commands:

export PATH="$PATH:/sbin"

Now your distro’s GRUB menu should work, when your distro’s GRUB bootloader is executed from Libreboot’s SeaBIOS payload.

Encrypted (LUKS/dm-crypt) installations

A better solution for encryption would be a Linux payload in flash, handling the encryption, at least if you want to use Linux, because then it’ll have perfect LUKS support.

GRUB otherwise has good filesystem support, so if you have a valid grub.cfg in /boot/grub on your installed system, Libreboot’s GRUB configuration has logic in it that will try to automatically use whatever you have installed, by switching to it. In this way, most installations Just Work, so long as the /boot partition is accessible.

Full encryption for basic LUKS2 is supported in libreboot. See the guide for more detail.

The ZFSbootmenu guide builds upon the main encryption guide but describes a setup with ZFS native encryption and ZFSbootmenu.

Rebooting system in case of freeze

Linux kernel has a feature to do actions to the system any time, even with it freezes, this is called a Magic SysRq keys. You can do these actions with Alt + Sysrq + Command. These are the actions:

If some of them don’t work, you have to enable it in the kernel command line paramter. So append sysrq_always_enabled=1 to your GRUB_CMDLINE_LINUX_DEFAULT in /etc/default/grub

You can also run # sysctl kernel.sysrq=1 to enable them.

Fedora won’t boot?

This may also apply to CentOS or Redhat. Chroot guide can be found on fedora website

linux16 issue

Libreboot’s default GRUB config sources fedora’s grub config grub.cfg (in /boot/grub2/grub.cfg), fedora by default makes use of the linux16 command, where it should be saying linux

Do this in fedora:

Open /etc/grub.d/10_linux

Set the sixteenbit variable to an empty string, then run:

grub2-mkconfig -o /boot/grub2/grub.cfg

BLS issue

With newer versions of fedora, scripts from grub package default to generating BLS instead of grub.cfg. To change that behaviour add following line to /etc/default/grub (or modify existing one if it already exists):


Then generate grub.cfg with:

grub2-mkconfig -o /boot/grub2/grub.cfg

Markdown file for this page:

Site map

This HTML page was generated by the untitled static site generator.