Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

NAME

bootc-uki-addon - Manage UKI addons on the EFI System Partition

SYNOPSIS

bootc uki-addon <COMMAND>

DESCRIPTION

This command is experimental and subject to change.

Manage UKI (Unified Kernel Image) addons on the EFI System Partition.

UKI addons are PE binaries that systemd-stub loads alongside the main UKI at boot. Addons can carry extra kernel command-line parameters and other resources that are merged into the boot configuration.

There are two types of addons:

  • Scoped addons are tied to a specific deployment. They are stored next to the deployment's UKI and are automatically cleaned up by garbage collection when the deployment is removed.

  • Global addons apply to every UKI on the ESP. They persist across deployments and are removed by garbage collection once no remaining deployment references them.

This command requires the composefs backend with UKI boot.

COMMANDS

list : List all installed UKI addons. See bootc-uki-addon-list(8).

add : Add a UKI addon from the booted image. See bootc-uki-addon-add(8).

remove : Remove a UKI addon from the ESP. See bootc-uki-addon-remove(8).

list-referenced : List UKI addons referenced by deployed images. See bootc-uki-addon-list-referenced(8).

EXAMPLES

List all installed addons:

bootc uki-addon list

Add a scoped addon from the booted image:

bootc uki-addon add debug scoped

Remove a global addon:

bootc uki-addon remove site-config

List all referenced addons:

bootc uki-addon list-referenced

SEE ALSO

bootc(8), bootc-uki-addon-list(8), bootc-uki-addon-add(8), bootc-uki-addon-remove(8), bootc-uki-addon-list-referenced(8)

VERSION


The Linux Foundation® (TLF) has registered trademarks and uses trademarks. For a list of TLF trademarks, see Trademark Usage.