kiwi::system::create - Create image from prepared root system
Contents
Copyright
2020-2025, Marcus Schäfer
10.2.28 Jul 24, 2025 KIWI::SYSTEM::CREATE(8)
Description
Create an image from the previously prepared image root directory. The kiwicreate command is normally
issued after the kiwiprepare command, and it and builds the requested image type in the specified target
directory.
Name
kiwi::system::create - Create image from prepared root system
Options
--root=<directory>
Path to the image root directory. This directory is normally created by the kiwiprepare command.
Keep in mind that if the specified directory is not created using the kiwiprepare command, KIWI
NG stores image build metadata in the image/ directory. This directory must exist for the kiwicreate command to work correctly.
--target-dir=<directory>
Path to store the build results.
--signing-key=<key-file>
Trusted key file to be imported into the package manager database before performing any operation.
This is useful if an image build validates repository and package signatures during build time. In
the create step, this option only affects the boot image. This option can be specified multiple
times.
Synopsis
kiwi-ng [global options] service <command> [<args>]
kiwi-ng system create -h | --help
kiwi-ng system create --root=<directory> --target-dir=<directory>
[--signing-key=<key-file>...]
kiwi-ng system create help
