mkosi 命令

常用示例

说明

mkosi builds customized, modern Linux OS images. It wraps package managers (dnf, apt, pacman, zypper) to generate disk images, container images, and unified kernel images with extensive customization options. Supported output formats include raw GPT disk images, plain directories, tar and CPIO archives, unified kernel images (UKI), and OCI-compatible images. The tool supports multiple distributions and can create bootable images with systemd-boot or GRUB. Configuration is read from mkosi.conf files, allowing declarative image definitions with support for profiles, conditional sections, and modular configurations.

参数

build

Generate the image (default if no verb specified)

shell

Interactive shell in built image via systemd-nspawn container

boot

Boot systemd in image container

vm (alias: qemu)

Boot image in virtual machine (QEMU by default).

ssh

Connect to booted VM via SSH

clean

Remove build artifacts

summary

Display human-readable configuration overview

cat-config

Output all loaded configuration file contents

burn _device_

Write image to block device

genkey

Generate SecureBoot keypairs

-f, --force

Replace existing output; repeat for cache purge

-i, --incremental

Enable caching between builds

-C, --directory _dir_

Change to directory before processing

--distribution _distro_

Target distribution: fedora, debian, ubuntu, arch, opensuse, etc.

--release _version_

Specific distribution version

--format _type_

Output type: directory, tar, disk, uki, etc.

--debug

Enable verbose output