---
name: "mkosi-addon"
section: "1"
platform: "linux"
package: "mkosi"
version: "27.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mkosi-addon"
---

# mkosi-addon(1)

Build addons for unified kernel images for the current system using mkosi

## NAME

mkosi-addon — Build addons for unified kernel images for the current system using mkosi

## SYNOPSIS

**mkosi-addon \[options...\]**

## DESCRIPTION

**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-sandbox** with **strace**.

- **--show-documentation**, **-D**

  Show the man page for mkosi-addon.

- **--version**

  Show package version.

- **--help**, **-h**

  Show brief usage information.

## SEE ALSO

[**mkosi**(1)](/mkosi/1.md)