mkosi-addon1
Build addons for unified kernel images for the current system using mkosi
Usage
mkosi-addon [options ...]
Overview
mkosi-addon is a wrapper on top of mkosi to simplify the generation of PE addons containing customizations for unified kernel images specific to the running or local system. Will include entries in /etc/crypttab marked with x-initrd.attach, and /etc/kernel/cmdline. Kernel modules and firmwares for the running hardware can be included if a local configuration with the option KernelModulesIncludeHost= is provided.
Options
--kernel-version=-
Kernel version where to look for the kernel modules to include. Defaults to the kernel version of the running system (
uname-r).
--output=,-o-
Name to use for the generated output addon. Defaults to
mkosi-local.addon.efi.
--output-dir=,-O-
Path to a directory where to place all generated artifacts. Defaults to the current working directory.
-
--debug -
Enable additional debugging output.
-
--debug-shell -
Spawn debug shell in sandbox if a sandboxed command fails.
-
--debug-sandbox -
Run
mkosi-sandboxwithstrace.
-
--show-documentation, -D -
Show the man page for mkosi-addon.
-
--version -
Show package version.
-
--help, -h -
Show brief usage information.
History
- Arch Linux 2026-11-01: the text shown here
- Debian 13 (Trixie)
--debug since Arch Linux 2026-11-01;
--debug-sandbox since Arch Linux 2026-11-01;
--debug-shell since Arch Linux 2026-11-01;
--show-documentation since Arch Linux 2026-11-01;
-D since Arch Linux 2026-11-01.