'\" t
.TH "BOOTCTL" "1" "" "systemd 241" "bootctl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
bootctl \- Control the firmware and boot manager settings
.SH "SYNOPSIS"
.HP \w'\fBbootctl\fR\ 'u
\fBbootctl\fR [OPTIONS...] {COMMAND}
.SH "DESCRIPTION"
.PP
\fBbootctl\fR
can check the EFI boot loader status, list available boot loaders and boot loader entries, and install, update, or remove the
\fBsystemd-boot\fR(7)
boot loader on the current system\&.
.SH "OPTIONS"
.PP
The following options are understood:
.PP
\fB\-\-path=\fR
.RS 4
Path to the EFI System Partition (ESP)\&. If not specified,
/efi,
/boot, and
/boot/efi
are checked in turn\&. It is recommended to mount the ESP to
/boot, if possible\&.
.RE
.PP
\fB\-p\fR, \fB\-\-print\-path\fR
.RS 4
This option modifies the behaviour of
\fBstatus\fR\&. Just print the path to the EFI System Partition (ESP) to standard output and exit\&.
.RE
.PP
\fB\-\-no\-variables\fR
.RS 4
Do not touch the firmware\*(Aqs boot loader list stored in EFI variables\&.
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
Do not pipe output into a pager\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Print a short help text and exit\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
Print a short version string and exit\&.
.RE
.SH "COMMANDS"
.PP
\fBstatus\fR
.RS 4
Shows brief information about the system firmware, the boot loader that was used to boot the system, the boot loaders currently available in the ESP, the boot loaders listed in the firmware\*(Aqs list of boot loaders and the current default boot loader entry\&. If no command is specified, this is the implied default\&.
.RE
.PP
\fBinstall\fR
.RS 4
Installs systemd\-boot into the EFI system partition\&. A copy of
\fBsystemd\-boot\fR
will be stored as the EFI default/fallback loader at
\fIESP\fR/EFI/BOOT/BOOT*\&.EFI\&. The boot loader is then added to the top of the firmware\*(Aqs boot loader list\&.
.RE
.PP
\fBupdate\fR
.RS 4
Updates all installed versions of
\fBsystemd-boot\fR(7), if the available version is newer than the version installed in the EFI system partition\&. This also includes the EFI default/fallback loader at
\fIESP\fR/EFI/BOOT/BOOT*\&.EFI\&. The boot loader is then added to end of the firmware\*(Aqs boot loader list if missing\&.
.RE
.PP
\fBremove\fR
.RS 4
Removes all installed versions of
\fBsystemd\-boot\fR
from the EFI system partition and the firmware\*(Aqs boot loader list\&.
.RE
.PP
\fBlist\fR
.RS 4
Shows all available boot loader entries implementing the
\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2, as well as any other entries discovered or automatically generated by the boot loader\&.
.RE
.PP
\fBset\-default\fR \fIID\fR, \fBset\-oneshot\fR \fIID\fR
.RS 4
Sets the default boot loader entry\&. Takes a single boot loader entry ID string as argument\&. The
\fBset\-oneshot\fR
command will set the default entry only for the next boot, the
\fBset\-default\fR
will set it persistently for all future boots\&.
.RE
.SH "EXIT STATUS"
.PP
On success, 0 is returned, a non\-zero failure code otherwise\&.
.SH "ENVIRONMENT"
.PP
If
\fI$SYSTEMD_RELAX_ESP_CHECKS=1\fR
is set the validation checks for the ESP are relaxed, and the path specified with
\fB\-\-path=\fR
may refer to any kind of file system on any kind of partition\&.
.SH "SEE ALSO"
.PP
\fBsystemd-boot\fR(7),
\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[1]\d\s+2,
\m[blue]\fBBoot Loader Interface\fR\m[]\&\s-2\u[2]\d\s+2
.SH "NOTES"
.IP " 1." 4
Boot Loader Specification
.RS 4
\%https://systemd.io/BOOT_LOADER_SPECIFICATION
.RE
.IP " 2." 4
Boot Loader Interface
.RS 4
\%https://systemd.io/BOOT_LOADER_INTERFACE
.RE