OS Manuals

/usr/bin/kernel-install

systemd bootloader

From systemd-boot 262.2-r1 (os), captured 2026-11-05 by running kernel-install --help (exit 0). permalink

> kernel-install [OPTION…] COMMAND …

Add and remove kernel and initrd images to and from the boot partition.

Commands:
  add [[[KERNEL-VERSION] KERNEL-IMAGE] [INITRD ...]]       Add a kernel and initrd images to the
                                                           boot partition
  add-all                                                  Add all kernels found in
                                                           /usr/lib/modules/
  remove KERNEL-VERSION                                    Remove a kernel from the boot partition
  [inspect [[[KERNEL-VERSION] KERNEL-IMAGE] [INITRD ...]]] Print details about the installation
  list                                                     List installed kernels
  help                                                     Show this help

Options:
  -h --help                           Show this help
     --version                        Show package version
     --no-legend                      Do not show headers and footers
  -v --verbose                        Increase verbosity
     --esp-path=PATH                  Path to the EFI System Partition (ESP)
     --boot-path=PATH                 Path to the $BOOT partition
     --make-entry-directory=BOOL|auto Create $BOOT/ENTRY-TOKEN/ directory
     --entry-token=TOKEN              Entry token to use for this installation (machine-id, os-id,
                                      os-image-id, auto, literal:…)
     --entry-type=TYPE                Operate only on the specified bootloader entry type (type1,
                                      type2, all)
     --no-pager                       Do not start a pager
     --json=FORMAT                    Generate JSON output (pretty, short, or off)
     --root=PATH                      Operate on an alternate filesystem root
     --image=PATH                     Operate on disk image as filesystem root
     --image-policy=POLICY            Specify disk image dissection policy

This program may also be invoked as 'installkernel':
  installkernel [OPTION…] VERSION VMLINUZ [MAP] [INSTALLATION-DIR]
(The optional arguments are passed by kernel build system, but ignored.)

See the kernel-install(8) man page for details.
Options (13)
OptionDescriptionSource
-h --helpShow this helphelp
--versionShow package versionhelp
--no-legendDo not show headers and footershelp
-v --verboseIncrease verbosityhelp
--esp-path PATHPath to the EFI System Partition (ESP)help
--boot-path PATHPath to the $BOOT partitionhelp
--entry-token TOKENEntry token to use for this installation (machine-id, os-id, os-image-id, auto, literal:…)help
--entry-type TYPEOperate only on the specified bootloader entry type (type1, type2, all)help
--no-pagerDo not start a pagerhelp
--json FORMATGenerate JSON output (pretty, short, or off)help
--root PATHOperate on an alternate filesystem roothelp
--image PATHOperate on disk image as filesystem roothelp
--image-policy POLICYSpecify disk image dissection policyhelp

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.