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.