loader.conf(5) — Linux manual page


LOADER.CONF(5)                 loader.conf                LOADER.CONF(5)

NAME         top

       loader.conf - Configuration file for systemd-boot

SYNOPSIS         top

       ESP/loader/loader.conf, ESP/loader/entries/*.conf

DESCRIPTION         top

       systemd-boot(7) will read ESP/loader/loader.conf and any files
       with the ".conf" extension under ESP/loader/entries/ on the EFI
       system partition (ESP).

       Each configuration file must consist of an option name, followed
       by whitespace, and the option value.  "#" may be used to start a
       comment line. Empty and comment lines are ignored.

       Boolean arguments may be written as "yes"/"y"/"true"/"t"/"on"/"1"
       or "no"/"n"/"false"/"f"/"off"/"0".

OPTIONS         top

       The following configuration options in loader.conf are

           A glob pattern to select the default entry. The default entry
           may be changed in the boot menu itself, in which case the
           name of the selected entry will be stored as an EFI variable,
           overriding this option.

           Table 1. Automatically detected entries will use the
           following names:
           │Name                          Description          │
           │auto-efi-default              │ EFI Default Loader   │
           │auto-efi-shell                │ EFI Shell            │
           │auto-osx                      │ macOS                │
           │auto-reboot-to-firmware-setup │ Reboot Into Firmware │
           │                              │ Interface            │
           │auto-windows                  │ Windows Boot Manager │

           How long the boot menu should be shown before the default
           entry is booted, in seconds. This may be changed in the boot
           menu itself and will be stored as an EFI variable in that
           case, overriding this option.

           If the timeout is disabled, the default entry will be booted
           immediately. The menu can be shown by pressing and holding a
           key before systemd-boot is launched.

           This option configures the resolution of the console. Takes a
           number or one of the special values listed below. The
           following values may be used:

               Standard UEFI 80x25 mode

               80x50 mode, not supported by all devices

               the first non-standard mode provided by the device
               firmware, if any

               Pick a suitable mode automatically using heuristics

               Pick the highest-numbered available mode

               Keep the mode selected by firmware (the default)

           Takes a boolean argument. Enable (the default) or disable the
           editor. The editor should be disabled if the machine can be
           accessed by unauthorized persons.

           Takes a boolean argument. Enable (the default) or disable
           entries for other boot entries found on the boot partition.
           In particular, this may be useful when loader entries are
           created to show replacement descriptions for those entries.

           Takes a boolean argument. Enable (the default) or disable the
           "Reboot into firmware" entry.

           Takes one of "off", "with-system-token" and "always". If
           "off" no random seed data is read off the ESP, nor passed to
           the OS. If "with-system-token" (the default) systemd-boot
           will read a random seed from the ESP (from the file
           /loader/random-seed) only if the LoaderSystemToken EFI
           variable is set, and then derive the random seed to pass to
           the OS from the combination. If "always" the boot loader will
           do so even if LoaderSystemToken is not set. This mode is
           useful in environments where protection against OS image
           reuse is not a concern, and the random seed shall be used
           even with no further setup in place. Use bootctl random-seed
           to initialize both the random seed file in the ESP and the
           system token EFI variable.

           See Random Seeds[1] for further information.

EXAMPLE         top

           # /boot/efi/loader/loader.conf
           timeout 0
           default 01234567890abcdef1234567890abdf0-*
           editor no

       The menu will not be shown by default (the menu can still be
       shown by pressing and holding a key during boot). One of the
       entries with files with a name starting with
       "01234567890abcdef1234567890abdf0-" will be selected by default.
       If more than one entry matches, the one with the highest priority
       will be selected (generally the one with the highest version
       number). The editor will be disabled, so it is not possible to
       alter the kernel command line.

SEE ALSO         top

       systemd-boot(7), bootctl(1)

NOTES         top

        1. Random Seeds

COLOPHON         top

       This page is part of the systemd (systemd system and service
       manager) project.  Information about the project can be found at
       ⟨http://www.freedesktop.org/wiki/Software/systemd⟩.  If you have
       a bug report for this manual page, see
       This page was obtained from the project's upstream Git repository
       ⟨https://github.com/systemd/systemd.git⟩ on 2021-08-27.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2021-08-27.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

systemd 249                                               LOADER.CONF(5)

Pages that refer to this page: systemd-boot(7)