Debian Codegraph @

upstream/debian-trixie/man7/mkosi.news.7

raw
1 .\" Automatically generated by Pandoc 3.1.11.1
2 .\"
3 .TH "mkosi.news" "7" "" "" ""
4 .SH mkosi Changelog
5 .SS v25
6 .IP \[bu] 2
7 Instead of using bubblewrap, sandboxing is now done with a new tool
8 \f[CR]mkosi\-sandbox\f[R].
9 This tool has a public API and can be used independently of mkosi.
10 .IP \[bu] 2
11 Image builds are now done in a user namespace with a single user when
12 running unprivileged instead of using newuidmap/newgidmap.
13 When running unprivileged, all files and directories in the image will
14 be owned by the invoking user (and by root inside any produced
15 archives).
16 Any attempt to chown files to other users in scripts will fail unless
17 the new environment variable \f[CR]$MKOSI_CHROOT_SUPPRESS_CHOWN\f[R] is
18 set to a true value.
19 .IP \[bu] 2
20 \f[CR]mkosi\f[R] does not drop privileges anymore to the invoking user
21 when running as root for various steps.
22 .IP \[bu] 2
23 A new \f[CR]cat\-config\f[R] verb will show all configuration files that
24 were included for each configured image.
25 .IP \[bu] 2
26 Added support for Azure Linux
27 .IP \[bu] 2
28 Added support for Kali Linux
29 .IP \[bu] 2
30 If \f[CR]mkosi.version\f[R] is executable, we now execute it and read
31 the version from stdout.
32 .IP \[bu] 2
33 Added \f[CR]\-\-wipe\-build\-dir\f[R] to wipe the build directory before
34 rebuilding the image.
35 .IP \[bu] 2
36 Introduced \f[CR]RepositoryKeyFetch=\f[R] to control whether to fetch
37 distribution GPG keys remotely.
38 This setting is \f[B]disabled\f[R] by default for security reasons
39 except when building rpm based or Arch Linux images on Ubuntu.
40 .IP \[bu] 2
41 We now handle \f[CR]SIGHUP\f[R] gracefully
42 .IP \[bu] 2
43 Universal settings that take a collection of values cannot be appended
44 to anymore in subimages.
45 Usage of package manager trees in subimages will have to be moved to the
46 top level image.
47 Similarly, repositories will have to be enabled in the top level image.
48 .IP \[bu] 2
49 Repository metadata is not copied into images anymore.
50 .IP \[bu] 2
51 Repository metadata from base trees is not used anymore.
52 .IP \[bu] 2
53 Package manager trees are now named sandbox trees.
54 .IP \[bu] 2
55 Package manager trees (sandbox trees) do not use the skeleton trees as
56 their default anymore if unset.
57 .IP \[bu] 2
58 Note to packagers: The manual pages have been moved to resources/man and
59 now include man pages for mkosi\-initrd and mkosi\-sandbox as well.
60 .IP \[bu] 2
61 \f[CR]InitrdInclude=\f[R] was removed.
62 If you\[cq]re using \f[CR]InitrdInclude=\f[R], please build your initrd
63 via a subimage in \f[CR]mkosi.images\f[R] containing
64 \f[CR]Include=mkosi\-initrd\f[R] and any customizations you wish to add
65 and use the \f[CR]Initrds=\f[R] setting to use it as the initrd for the
66 main image instead of the default initrd.
67 .IP \[bu] 2
68 Added \f[CR]History=\f[R] to have mkosi save the config used to build
69 the image and reuse it when verbs such as \f[CR]qemu\f[R],
70 \f[CR]boot\f[R], \&...
71 are invoked without \f[CR]\-f\f[R].
72 .IP \[bu] 2
73 Introduced new \f[CR][Build]\f[R] section and moved various settings to
74 it.
75 .IP \[bu] 2
76 Moved \f[CR]Include=\f[R] to \f[CR][Include]\f[R] section
77 .IP \[bu] 2
78 Added \f[CR]sysupdate\f[R] verb as a wrapper around
79 \f[CR]systemd\-sysupdate\f[R] which invokes it with definitions from
80 \f[CR]mkosi.sysupdate\f[R].
81 .IP \[bu] 2
82 Added \f[CR]RuntimeHome=\f[R] to mount the current home directory to
83 \f[CR]/root\f[R] when running a command that boots the image
84 .IP \[bu] 2
85 More directories aside from \f[CR]/etc\f[R] and \f[CR]/usr\f[R] are now
86 picked up from sandbox trees (formerly known as package manager trees).
87 .IP \[bu] 2
88 Profile configuration from \f[CR]mkosi.profiles\f[R] is now parsed after
89 \f[CR]mkosi.conf.d\f[R] instead of before it.
90 To set defaults for use in \f[CR]mkosi.conf.d\f[R] based on the
91 configured profile, use an early dropin in \f[CR]mkosi.conf.d\f[R] that
92 matches on the configured profile instead.
93 .IP \[bu] 2
94 \f[CR]Profile=\f[R] is renamed to \f[CR]Profiles=\f[R] and takes a comma
95 separated list of profiles now.
96 Scripts now receive \f[CR]$PROFILES\f[R] with a space\-separated list of
97 profiles instead of \f[CR]$PROFILE\f[R].
98 The \f[CR]%p\f[R] specifier for profiles is removed.
99 .IP \[bu] 2
100 Multiple sync, prepare, build, postinst, finalize, postoutput and clean
101 scripts are now picked up from \f[CR]mkosi.$SCRIPT.d\f[R].
102 .IP \[bu] 2
103 \f[CR]run0\f[R] is now automatically used to escalate privileges for
104 commands that need it, like the \f[CR]burn\f[R] verb.
105 .IP \[bu] 2
106 \f[CR]/usr/share/keyrings\f[R] and
107 \f[CR]/usr/share/distribution\-gpg\-keys\f[R] are no longer
108 automatically picked up from the tools tree when
109 \f[CR]ToolsTreeCertificates=\f[R] is set, since they aren\[cq]t
110 certificates, use a sandbox tree instead.
111 This allows one to override \f[CR]SignedBy=\f[R] keys for APT
112 repositories.
113 .IP \[bu] 2
114 The \f[CR]agetty.autologin\f[R] and \f[CR]login.noauth\f[R] credentials
115 are no longer set unconditionally.
116 .IP \[bu] 2
117 Access to the output directory in build scripts was removed.
118 To put artifacts from the build directory into the output directory,
119 copy them from the build directory to the output directory in a
120 post\-installation script which does have access to the build directory
121 and the output directory.
122 .IP \[bu] 2
123 \f[CR]BuildDirectory=\f[R] is no longer available in
124 \f[CR]PrepareScripts=\f[R].
125 If you need to acquire some files for the build process place them
126 somewhere sensible within \f[CR]$BUILDROOT\f[R] so that they can be
127 cached when building incrementally.
128 .IP \[bu] 2
129 When using a tools tree and a relaxed sandbox is used to run a command
130 (qemu, nspawn, \&...), we now keep all entries from \f[CR]$PATH\f[R]
131 outside of \f[CR]/usr\f[R] intact.
132 Note that this may cause issues if a \f[CR]$PATH\f[R] entry contains
133 binaries linked against libraries in \f[CR]/usr\f[R] from the host.
134 .IP \[bu] 2
135 Introduced a new specifier \f[CR]%I\f[R] which resolves to the name of
136 the current subimage when used in a config under
137 \f[CR]mkosi.images/\f[R].
138 This differs to \f[CR]%o\f[R] as it is always the name of the config
139 file without extension (or the name of the directory).
140 .IP \[bu] 2
141 If \f[CR]/dev/fuse\f[R] is found in the host context, it is made
142 available in the sandbox context too.
143 .IP \[bu] 2
144 Added a \f[CR]sandbox\f[R] verb to run a command within a relaxed mkosi
145 sandbox (the same sandbox that \f[CR]mkosi vm\f[R],
146 \f[CR]mkosi boot\f[R], \&...
147 run in).
148 .IP \[bu] 2
149 OpenSSL providers are now supported as key sources for the various key
150 settings if a recent enough systemd version (257 or newer) is used.
151 .IP \[bu] 2
152 Added support for loading X.509 certificates from OpenSSL providers if a
153 recent enough systemd version (257 or newer) is used.
154 .IP \[bu] 2
155 Added \f[CR]ToolsTreePackageDirectories=\f[R]
156 .IP \[bu] 2
157 Added \f[CR]\-\-kernel\-image=\f[R] to \f[CR]mkosi\-initrd\f[R] to
158 specify the kernel image to use when building a UKI.
159 .IP \[bu] 2
160 Setting a collection based setting to the empty string via the CLI and
161 then appending to the same setting will now override the settings coming
162 from configuration files, whereas previously the CLI values would be
163 appended to the values from configuration files.
164 .IP \[bu] 2
165 The \f[CR]mkosi\-initrd\f[R] default config now includes various extra
166 kernel modules by default.
167 .IP \[bu] 2
168 The \f[CR]coredumpctl\f[R] and \f[CR]journalctl\f[R] verbs will now
169 always operate on the image, even if \f[CR]ForwardJournal=\f[R] is
170 configured.
171 .IP \[bu] 2
172 Bumped default Fedora release to \f[CR]41\f[R].
173 .IP \[bu] 2
174 Added \f[CR]addon\f[R] output format to build UKI addons.
175 .IP \[bu] 2
176 Renamed \f[CR][Host]\f[R] section to \f[CR][Runtime]\f[R] section.
177 .IP \[bu] 2
178 Renamed various settings from \f[CR][Host]\f[R].
179 .IP \[bu] 2
180 Binaries coming from \f[CR]ExtraSearchPaths=\f[R] are now executed with
181 the tools tree mounted if one is configured (unlike before where the
182 tools tree was not mounted).
183 This means that any binaries coming from \f[CR]ExtraSearchPaths=\f[R]
184 have to be linked against libraries from the tools tree (or have to be
185 statically linked).
186 Alternatively, the tools tree distribution and release have to match the
187 host.
188 .IP \[bu] 2
189 Binaries from \f[CR]ExtraSearchPaths=\f[R] are not used anymore when
190 building the default tools tree.
191 .IP \[bu] 2
192 Dropped support for \f[CR]pesign\f[R] as a secure boot signing tool.
193 .IP \[bu] 2
194 Added support for \f[CR]systemd\-sbsign\f[R] as a secure boot signing
195 tool.
196 .IP \[bu] 2
197 Added \f[CR]\-\-register=\f[R] to control whether to register containers
198 and VMs with systemd\-machined or not.
199 .IP \[bu] 2
200 \f[CR]mkosi.profiles\f[R] is now parsed in subimages as well.
201 .IP \[bu] 2
202 \f[CR]mkosi\-initrd\f[R] now uses \f[CR]dnf5\f[R] on systems where it is
203 the default.
204 .IP \[bu] 2
205 Added various packages to the default tools tree.
206 .IP \[bu] 2
207 Dropped support for Ubuntu Focal.
208 .IP \[bu] 2
209 Added \f[CR]Devicetree=\f[R] setting for configuring bootloader device
210 trees
211 .IP \[bu] 2
212 Added systemd\-machined registration using varlink for
213 \f[CR]mkosi qemu\f[R] vms, which includes the vsock CID so that
214 \f[CR]ssh vsock/<cid>\f[R] or \f[CR]ssh machine/<name>\f[R] will work on
215 systems running \f[CR]systemd\-machined\f[R] 257 or newer.
216 .IP \[bu] 2
217 Bumped CentOS Stream default release to 10.
218 .IP \[bu] 2
219 mkosi now manages the pacman keyring itself so
220 \f[CR]/etc/pacman.d/gnupg\f[R] from the host is not used anymore and
221 mkosi will run \f[CR]pacman\-key \-\-init\f[R] and
222 \f[CR]pacman\-key \-\-populate\f[R] itself.
223 .IP \[bu] 2
224 Added \f[CR]ToolsTreeRelease=\f[R] match
225 .IP \[bu] 2
226 mkosi now enforces that images built with \f[CR]Overlay=yes\f[R] only
227 add files on top of the base tree(s) and don\[cq]t overwrite any
228 existing files or directories.
229 .IP \[bu] 2
230 Added a \f[CR]mkosi\-addon\f[R] tool and accompanying kernel\-install
231 plugin that allows building PE addons to extend a vendor provided
232 unified kernel image.
233 .IP \[bu] 2
234 Added \f[CR]systemd\-boot\-signed\f[R], \f[CR]uki\-signed\f[R] and
235 \f[CR]grub\-signed\f[R] variants for the \f[CR]Bootloader=\f[R] option
236 which instruct mkosi to only install pre\-signed EFI binaries.
237 .IP \[bu] 2
238 \f[CR]mkosi.profiles\f[R] is now parsed in configuration included with
239 \f[CR]Include=\f[R].
240 .IP \[bu] 2
241 Any initrds configured with \f[CR]Initrds=\f[R] are now used as fallback
242 when booting with qemu direct kernel boot
243 (\f[CR]\-\-firmware=linux\f[R]) if no split initrd was produced by the
244 image build.
245 .IP \[bu] 2
246 mkosi now makes a greater effort to ensure the crypto\-policies are
247 configured to allow GPG keys from older distributions.
248 .IP \[bu] 2
249 We don\[cq]t pick up pre\-signed bootloader binaries anymore when
250 \f[CR]ShimBootloader=signed\f[R] is configured.
251 To force usage of pre\-signed EFI binaries, use the new
252 \f[CR]systemd\-boot\-signed\f[R], \f[CR]uki\-signed\f[R] and
253 \f[CR]grub\-signed\f[R] variants for the \f[CR]Bootloader=\f[R] option.
254 .IP \[bu] 2
255 Added a new constant \f[CR]microsoft\-mok\f[R] for the
256 \f[CR]FirmwareVariables=\f[R] option.
257 If specified, a firmware variables file with the Microsoft keys enrolled
258 will be extended to include a \f[CR]MokList\f[R] entry that trusts the
259 certificate configured with \f[CR]SecureBootCertificate=\f[R] and passed
260 to \f[CR]qemu\f[R].
261 .IP \[bu] 2
262 We now use \f[CR]mkosi.pkgcache\f[R] as the package cache directory if
263 the directory exists.
264 .IP \[bu] 2
265 \f[CR]BuildSourcesEphemeral=\f[R] learned a new variant
266 \f[CR]buildcache\f[R] in which case the overlay will be cached in the
267 build directory configured with \f[CR]BuildDirectory=\f[R].
268 .SS v24
269 .IP \[bu] 2
270 The default kernel command line of \f[CR]console=ttyS0\f[R] (or
271 equivalent for other architectures) has been removed.
272 The required \f[CR]console=\f[R] argument to have the kernel output to
273 the serial console has to be added manually from \f[CR]v24\f[R] onwards.
274 .IP \[bu] 2
275 Support for installing local packages located in directories in
276 \f[CR]BuildSources=\f[R] was dropped.
277 Instead, the packages can be made available for installation via
278 \f[CR]PackageManagerTrees=\f[R].
279 .IP \[bu] 2
280 Configuration parsing was reworked to remove the need for the
281 \f[CR]\[at]\f[R] specifier and to streamline building multiple images
282 with \f[CR]mkosi.images/\f[R].
283 If you were building multiple images with \f[CR]mkosi.images/\f[R],
284 you\[cq]ll need to adapt your configuration to the rework.
285 Read the \f[B]Building multiple images\f[R] section in the documentation
286 for more information.
287 .IP \[bu] 2
288 mkosi has gained the option to generate completion scripts for bash,
289 fish and zsh.
290 Packagers should generate the scripts during packaging and ship them in
291 the appropriate places.
292 .IP \[bu] 2
293 Added support for CentOS Stream 10.
294 .IP \[bu] 2
295 mkosi now installs a separate \f[CR]mkosi\-initrd\f[R] script that can
296 be used to build initramfs images intended for use on the local system.
297 .IP \[bu] 2
298 We do not automatically append \f[CR]centos\-stream\f[R] or
299 \f[CR]fedora\f[R] anymore to CentOS (and derivatives) and Fedora mirrors
300 specified with \f[CR]Mirror=\f[R] as not all mirrors store the
301 repository metadata under these subdirectories.
302 Users are now required to add these subdirectories themselves in
303 \f[CR]Mirror=\f[R].
304 If the EPEL repositories are enabled for CentOS Stream (and derivatives)
305 and \f[CR]Mirror=\f[R] is used, we look for the EPEL repositories in
306 \f[CR]../fedora\f[R] relative to the mirror specified in
307 \f[CR]Mirror=\f[R].
308 .IP \[bu] 2
309 We now support compressed tar archives wherever we already accept tar
310 archives as input.
311 .IP \[bu] 2
312 We now always rerun the build if \f[CR]Format=none\f[R] and don\[cq]t
313 remove previous outputs in that case (unless \f[CR]\-\-force\f[R] is
314 specified).
315 This allows using \f[CR]mkosi \-t none\f[R] to rerun the build scripts
316 without removing the previous image.
317 This can then be combined with \f[CR]RuntimeBuildSources=yes\f[R] to
318 make the build script outputs available in a booted container or virtual
319 machine so they can be installed without having to rebuild the image.
320 .IP \[bu] 2
321 We now use \f[CR]virtconsole\f[R] to provide the serial console when
322 booting with \f[CR]qemu\f[R].
323 .IP \[bu] 2
324 \f[CR]root=PARTUUID\f[R] and \f[CR]mount.usr=PARTUUID\f[R] on the kernel
325 command line are now automatically extended with the actual PARTUUID of
326 the corresponding partition.
327 .IP \[bu] 2
328 All available OpenSUSE repositories are now supported and can be enabled
329 with \f[CR]Repositories=\f[R].
330 .IP \[bu] 2
331 Building OpenSUSE \f[CR]aarch64\f[R] images is now supported
332 .IP \[bu] 2
333 \f[CR]mkosi dependencies\f[R] was beefed up to handle more scenarios
334 properly
335 .IP \[bu] 2
336 The default list of kernel modules that are always added to the
337 initramfs was extended with various virtualization modules.
338 .IP \[bu] 2
339 Added a \f[CR]Repositories=\f[R] match.
340 .IP \[bu] 2
341 Cached images are now invalidated if packages specified via
342 \f[CR]PackageDirectories=\f[R] change.
343 .IP \[bu] 2
344 Added \f[CR]VolatilePackageDirectories=\f[R] which can be used to
345 provide local packages that do not invalidate cached images.
346 .IP \[bu] 2
347 \f[CR]mkosi.pkgmngr\f[R] is now used as the default path for
348 \f[CR]PackageManagerTrees=\f[R].
349 .IP \[bu] 2
350 The package directory that build scripts can use to make built packages
351 available for installation (\f[CR]$PACKAGEDIR\f[R]) is now shared
352 between all image builds.
353 This means that packages built in earlier images and stored in
354 \f[CR]$PACKAGEDIR\f[R] become available for installation in all
355 subsequent image builds.
356 .IP \[bu] 2
357 The default tools tree distribution is now chosen based on the host
358 distribution instead of the target distribution.
359 .IP \[bu] 2
360 mkosi can now be invoked from the initramfs.
361 .SS v23.1
362 .IP \[bu] 2
363 Respin due to git tag mismatch
364 .SS v23
365 .IP \[bu] 2
366 Added \f[CR]CleanScripts=\f[R] to allow running custom cleanup code
367 whenever mkosi cleans up the output directory.
368 This allows cleaning up extra outputs produced by e.g.\ a build script
369 that mkosi doesn\[cq]t know about.
370 .IP \[bu] 2
371 Added \f[CR]ConfigureScripts=\f[R] to allow dynamically modifying the
372 mkosi configuration.
373 Each configure script receives the current config as JSON on stdin and
374 should output the new config as JSON on stdout.
375 .IP \[bu] 2
376 When building a UKI, we don\[cq]t measure for the TPM SHA1 PCR bank
377 anymore.
378 .IP \[bu] 2
379 All keys in the mkosi config JSON output are now in pascal case, except
380 for credentials and environments, where the keys encode names of
381 credentials and environment variables and are therefore case sensitive.
382 .IP \[bu] 2
383 Added various settings to allow running mkosi behind a proxy.
384 .IP \[bu] 2
385 Various fixes to kernel module filtering that should result in fewer
386 modules being pulled into the default initrd when
387 \f[CR]KernelModulesExclude=\f[R] or
388 \f[CR]KernelModulesInitrdExclude=\f[R] are used.
389 .IP \[bu] 2
390 Added \f[CR]ToolsTreeDistribution=\f[R] match.
391 .IP \[bu] 2
392 Removed \f[CR]vmspawn\f[R] verb and replaced it with
393 \f[CR]VirtualMachineMonitor=\f[R].
394 .IP \[bu] 2
395 New specifiers for various directories were added.
396 \f[CR]%D\f[R] resolves to the directory that mkosi was invoked in,
397 \f[CR]%P\f[R] to the current working directory, and \f[CR]%C\f[R] to the
398 parent directory of the config file.
399 .IP \[bu] 2
400 Added \f[CR]ForwardJournal=\f[R] to have systemd inside a container/VM
401 forward its journal to the specified file or directory.
402 .IP \[bu] 2
403 Systemd scopes are now allocated for qemu, swtpm, virtiofsd and
404 systemd\-journal\-remote if available.
405 .IP \[bu] 2
406 The \f[CR]mkosi qemu\f[R] virtual machine is now registered with
407 systemd\-machined if available.
408 .IP \[bu] 2
409 Added new \f[CR]oci\f[R] output format
410 .IP \[bu] 2
411 Runtime trees without a target are now mounted to \f[CR]/root/src\f[R]
412 instead of a subdirectory of it (To have the same behaviour as
413 \f[CR]BuildSources=\f[R]).
414 .IP \[bu] 2
415 Added \f[CR]RuntimeBuildSources=\f[R] to mount build and source
416 directories when booting the image with \f[CR]mkosi nspawn\f[R] or
417 \f[CR]mkosi qemu\f[R].
418 .IP \[bu] 2
419 Introduced \f[CR]\-\-append\f[R] to allow command line settings to be
420 parsed after parsing configuration files.
421 .IP \[bu] 2
422 \f[CR]distribution\-release\f[R] is not installed by default anymore on
423 OpenSUSE.
424 .IP \[bu] 2
425 Setting \f[CR]QemuSmp=\f[R] to \f[CR]0\f[R] will now make qemu use all
426 available CPUs
427 .IP \[bu] 2
428 Free page reporting and discard request processing are now enabled by
429 default in VMs spawned by \f[CR]mkosi qemu\f[R].
430 .IP \[bu] 2
431 Added \f[CR]ToolsTreeCertificates=\f[R] to allow configuring whether to
432 use certificates and keys from the tools tree (if one is used) or the
433 host.
434 .IP \[bu] 2
435 Added \f[CR]never\f[R] for \f[CR]CacheOnly=\f[R] to specify that
436 repository metadata should always be refreshed.
437 .IP \[bu] 2
438 Renamed the \f[CR]none\f[R] option for \f[CR]CacheOnly=\f[R] to
439 \f[CR]auto\f[R].
440 .IP \[bu] 2
441 Added \f[CR]ProxyExclude=\f[R] to configure hostnames for which requests
442 should not go through the configured proxy.
443 .IP \[bu] 2
444 The default tools tree is now reused on incremental builds.
445 .IP \[bu] 2
446 Added \f[CR]VolatilePackages=\f[R] and
447 \f[CR]InitrdVolatilePackages=\f[R] to configure packages that should be
448 installed after executing build scripts and which should not be cached
449 when using \f[CR]Incremental=\f[R].
450 .IP \[bu] 2
451 \f[CR]PackageDirectories=\f[R] now has an associated default path
452 \f[CR]mkosi.packages\f[R].
453 .IP \[bu] 2
454 \f[CR]reprepro\f[R] is now used to generate local apt repositories.
455 .IP \[bu] 2
456 Support for BSD tar/cpio was dropped.
457 .IP \[bu] 2
458 When both \f[CR]ExtraSearchPaths=\f[R] and \f[CR]ToolsTree=\f[R] are
459 used, mkosi will now prefer running a binary found in
460 \f[CR]ExtraSearchPaths=\f[R] without the tools tree over running the
461 binary from the tools tree.
462 If a binary is not found in \f[CR]ExtraSearchPaths=\f[R], the tools tree
463 is used instead.
464 .IP \[bu] 2
465 An artifact directory is now made available when running scripts which
466 can be used to pass around data between different scripts.
467 mkosi will also look for microcode and initrds in the artifact directory
468 under the \f[CR]io.mkosi.microcode\f[R] and \f[CR]io.mkosi.initrd\f[R]
469 subdirectories.
470 .IP \[bu] 2
471 Added \f[CR]Environment=\f[R] match setting to check for environment
472 variables defined with the \f[CR]Environment=\f[R] setting.
473 .IP \[bu] 2
474 The \f[CR]basesystem\f[R] package is now always installed in Fedora and
475 CentOS images instead of the \f[CR]filesystem\f[R] package.
476 .IP \[bu] 2
477 The \f[CR]qemu\f[R], \f[CR]shell\f[R] and \f[CR]boot\f[R] verbs do not
478 automatically build the image anymore unless \f[CR]\-\-force\f[R] is
479 specified.
480 .IP \[bu] 2
481 \f[CR]SplitArtifacts=\f[R] is now supported for the portable, sysext and
482 confext outputs.
483 .IP \[bu] 2
484 The \f[CR]WithDocs=\f[R] option was implemented for pacman\-based
485 distributions.
486 .IP \[bu] 2
487 The default Fedora release was bumped to 40.
488 .IP \[bu] 2
489 \f[CR]QemuSwtpm=\f[R] can now be used with \f[CR]QemuFirmware=\f[R] set
490 to \f[CR]linux\f[R] or \f[CR]bios\f[R].
491 .IP \[bu] 2
492 Added \f[CR]UnitProperties=\f[R] to allow configure properties on the
493 scopes generated by \f[CR]systemd\-nspawn\f[R] and
494 \f[CR]systemd\-run\f[R].
495 .IP \[bu] 2
496 mkosi now only builds a single default tools tree per build using the
497 settings from the last regular image that we\[cq]ll build.
498 .IP \[bu] 2
499 Configure scripts are now only executed for verbs which imply an image
500 build and are executed with the tools tree instead of without it.
501 .IP \[bu] 2
502 \f[CR]$QEMU_ARCHITECTURE\f[R] is now set for configure scripts to easily
503 allow scripts to figure out which qemu binary will be used to run qemu.
504 .IP \[bu] 2
505 A file ID can now be specified for \f[CR]QemuDrives=\f[R].
506 This allows adding multiple qemu drives that are backed by the same
507 file.
508 .IP \[bu] 2
509 mkosi doesn\[cq]t fail anymore if images already exist when running
510 \f[CR]mkosi build\f[R].
511 .IP \[bu] 2
512 Image names from \f[CR]mkosi.images/\f[R] are now preferred over the
513 specified image ID when determining the output filename to use for an
514 image.
515 .IP \[bu] 2
516 \f[CR]\-\-include\f[R] now has a shorthand option \f[CR]\-I\f[R].
517 .IP \[bu] 2
518 The \f[CR]WITH_NETWORK\f[R] environment variable is now passed to build
519 and finalize scripts.
520 .IP \[bu] 2
521 We now clamp mtimes to the specified source date epoch timestamp instead
522 of resetting all mtimes.
523 This means that we won\[cq]t touch any mtimes that are already older
524 than the given source date epoch timestamp.
525 .IP \[bu] 2
526 Removed support for CentOS 8 Stream as it is now EOL.
527 .IP \[bu] 2
528 The \f[CR]coredumpctl\f[R] and \f[CR]journalctl\f[R] verbs now operrate
529 on the path specified in \f[CR]ForwardJournal=\f[R] if one is set.
530 .IP \[bu] 2
531 Added \f[CR]UnifiedKernelImageFormat=\f[R] format setting to allow
532 configuring the naming of unified kernel images generated by mkosi.
533 .IP \[bu] 2
534 The \f[CR]versionlock\f[R] plugin is now enabled by default for dnf with
535 a noop configuration.
536 .IP \[bu] 2
537 \f[CR]Repositories=\f[R] is now implemented for zypper.
538 .IP \[bu] 2
539 \f[CR]KernelModulesInclude=\f[R] and
540 \f[CR]KernelModulesInitrdInclude=\f[R] now take the special values
541 \f[CR]host\f[R] and \f[CR]default\f[R] to include the host\[cq]s loaded
542 modules and the default kernel modules defined in
543 \f[CR]mkosi\-initrd\f[R] respectively.
544 .IP \[bu] 2
545 \f[CR]KernelModulesIncludeHost=\f[R] and
546 \f[CR]KernelModulesInitrdIncludeHost=\f[R] are now deprecated.
547 .IP \[bu] 2
548 Added \f[CR]mkosi dependencies\f[R] to output the list of packages
549 required by mkosi to build and boot images.
550 .SS v22
551 .IP \[bu] 2
552 We\[cq]ll now try to delete btrfs subvolumes with
553 \f[CR]btrfs subvolume delete\f[R] first before falling back to
554 recursively deleting the directory.
555 .IP \[bu] 2
556 The invoking user is now always mapped to \f[CR]root\f[R] when running
557 sync scripts.
558 This fixes an issue where we would fail when a package manager tree or
559 skeleton tree contained a \f[CR]/usr\f[R] directory as we would not have
560 permissions to run mount in the sandbox.
561 .IP \[bu] 2
562 We now use qemu\[cq]s official firmware descriptions to find EDK2/OVMF
563 UEFI firmware.
564 Addititionally, \f[CR]QemuFirmware=uefi\f[R] now boots without
565 SecureBoot support, and \f[CR]QemuFirmware=uefi\-secure\-boot\f[R] was
566 introduced to boot with SecureBoot support.
567 By default we will still boot with SecureBoot support if
568 \f[CR]QemuFirmware=auto\f[R].
569 .IP \[bu] 2
570 Added support for \f[CR]QemuFirmwareVariables=custom\f[R] and
571 \f[CR]QemuFirmwareVariables=microsoft\f[R] to use OVMF/EDK2 variables
572 with either the user\[cq]s custom keys enrolled or with the Microsoft
573 keys enrolled.
574 .IP \[bu] 2
575 Added \f[CR]UnifiedKernelImages=\f[R] to control whether we generate
576 unified kernel images or not.
577 .IP \[bu] 2
578 \f[CR]Bootloader=grub\f[R] will now generate a grub EFI image and
579 install it.
580 If \f[CR]SecureBoot=\f[R] is enabled and \f[CR]ShimBootloader=\f[R] is
581 not set to \f[CR]signed\f[R], the grub EFI image will be signed for
582 SecureBoot.
583 .IP \[bu] 2
584 \f[CR]ShimBootloader=signed\f[R] will now also instruct mkosi to look
585 for and install already signed grub, systemd\-boot, kernel and UKI
586 binaries.
587 .IP \[bu] 2
588 We now build grub images with a fixed set of modules and don\[cq]t copy
589 any grub modules to the ESP anymore.
590 .IP \[bu] 2
591 The configuration is now made available as a JSON file to all mkosi
592 scripts via the \f[CR]$MKOSI_CONFIG\f[R] environment variable.
593 .IP \[bu] 2
594 \f[CR]$PROFILE\f[R] is now set for all mkosi scripts containing the
595 value of \f[CR]Profile=\f[R] if it is set.
596 .SS v21
597 .IP \[bu] 2
598 We now handle unmerged\-usr systems correctly
599 .IP \[bu] 2
600 Builtin configs (\f[CR]mkosi\-initrd\f[R], \f[CR]mkosi\-tools\f[R]) can
601 now be included using \f[CR]Include=\f[R]
602 (e.g.\ \f[CR]Include=mkosi\-initrd\f[R])
603 .IP \[bu] 2
604 The kernel\-install plugin now uses the builtin \f[CR]mkosi\-initrd\f[R]
605 config so there\[cq]s no need anymore to copy the full
606 \f[CR]mkosi\-initrd\f[R] config into \f[CR]/usr/lib/mkosi\-initrd\f[R].
607 .IP \[bu] 2
608 We don\[cq]t require a build anymore for the \f[CR]journalctl\f[R] and
609 \f[CR]coredumpctl\f[R] verbs.
610 .IP \[bu] 2
611 \f[CR]mkosi ssh\f[R] works again when used with
612 \f[CR]ToolsTree=default\f[R]
613 .IP \[bu] 2
614 We now use \f[CR].zst\f[R] instead of \f[CR].zstd\f[R] for compressed
615 split artifacts produced by \f[CR]systemd\-repart\f[R].
616 .IP \[bu] 2
617 \f[CR]systemd\-repart\f[R] uses a persistent temporary directory again
618 for assembling images instead of a tmpfs.
619 .IP \[bu] 2
620 Added \f[CR]MicrocodeHost=\f[R] setting to only include the CPU specific
621 microcode for the current host system.
622 .IP \[bu] 2
623 The kernel\-install plugin now only includes the CPU specific microcode
624 .IP \[bu] 2
625 Introduced \f[CR]PackageCacheDirectory=\f[R] to set the directory for
626 package manager caches.
627 This setting defaults to a suitable location in the system or user
628 directory depending on how mkosi is invoked.
629 \f[CR]CacheDirectory=\f[R] is only used for incremental cached images
630 now.
631 .IP \[bu] 2
632 Repository metadata is now synced once at the start of each image build
633 and never during an image build.
634 Each image includes a snapshot of the repository metadata in the
635 canonical locations in \f[CR]/var\f[R] so that incremental images and
636 extension images can reuse the same snapshot.
637 When building an image intended to be used with \f[CR]BaseTrees=\f[R],
638 disable \f[CR]CleanPackageMetadata=\f[R] to make sure the repository
639 metadata in \f[CR]/var\f[R] is not cleaned up, otherwise any extension
640 images using this image as their base tree will not be able to install
641 additional packages.
642 .IP \[bu] 2
643 Implemented \f[CR]CacheOnly=metadata\f[R].
644 Note that in the JSON output, the value of \f[CR]CacheOnly=\f[R] will
645 now be a string instead of a boolean.
646 .IP \[bu] 2
647 Added \f[CR]CompressLevel=\f[R] to set the compression level to use.
648 .IP \[bu] 2
649 Dropped experimental Gentoo support.
650 .IP \[bu] 2
651 Added \f[CR]TriggerMatch=\f[R] to specify multiple match sections of
652 which only one should be satisfied.
653 .IP \[bu] 2
654 Added \f[CR]jq\f[R], \f[CR]attr\f[R], \f[CR]acl\f[R], \f[CR]git\f[R],
655 \f[CR]sed\f[R], \f[CR]grep\f[R] and \f[CR]findutils\f[R] to the default
656 tools tree.
657 .IP \[bu] 2
658 Added \f[CR]mkosi\-install\f[R], \f[CR]mkosi\-upgrade\f[R],
659 \f[CR]mkosi\-remove\f[R] and \f[CR]mkosi\-reinstall\f[R] scripts which
660 allow writing scripts that are independent of the package manager being
661 used to build the image.
662 .IP \[bu] 2
663 We now expand specifiers in \f[CR]Match\f[R] section values
664 .IP \[bu] 2
665 Made GPG key handling for Fedora rawhide more robust
666 .IP \[bu] 2
667 If systemd\-repart 256 or newer is available, mkosi will instruct it to
668 generate \f[CR]/etc/fstab\f[R] and \f[CR]/etc/crypttab\f[R] for the
669 image if any partition definitions contain the corresponding settings
670 (\f[CR]MountPoint=\f[R] and \f[CR]EncryptedVolume=\f[R]).
671 .IP \[bu] 2
672 \f[CR]bash\f[R] is now started in the debug shell instead of
673 \f[CR]sh\f[R].
674 .IP \[bu] 2
675 The default release for Ubuntu is now \f[CR]noble\f[R].
676 .IP \[bu] 2
677 Ubuntu is now used as the default tools tree distribution for Ubuntu
678 instead of Debian.
679 .IP \[bu] 2
680 Added \f[CR]mkosi vmspawn\f[R] which boots the image with
681 \f[CR]systemd\-vmspawn\f[R].
682 Note that \f[CR]systemd\-vmspawn\f[R] is experimental and its interface
683 may still change.
684 As such \f[CR]mkosi vmspawn\f[R] is also considered experimental.
685 Note that \f[CR]systemd\-vmspawn\f[R] version \f[CR]256\f[R] or newer is
686 required.
687 .IP \[bu] 2
688 Added \f[CR]SyncScripts=\f[R] which can be used to update various build
689 sources before starting the image build.
690 .IP \[bu] 2
691 The \f[CR]DISTRIBUTION=\f[R] and \f[CR]RELEASE=\f[R] environment
692 variables are now set when running scripts.
693 .IP \[bu] 2
694 Added \f[CR]ToolsTreeRepositories=\f[R] and
695 \f[CR]ToolsTreePackageManagerTrees=\f[R].
696 .IP \[bu] 2
697 Added \f[CR]RuntimeNetwork=\f[R] to configure the networking used when
698 booting the image.
699 .IP \[bu] 2
700 Added \f[CR]SecureBootKeySource=\f[R] and \f[CR]VerityKeySource=\f[R] to
701 support signing images with OpenSSL engines.
702 Note that these settings require various systemd tools to be version
703 \f[CR]256\f[R] or newer.
704 .IP \[bu] 2
705 We don\[cq]t clean up package manager metadata anymore unless explicitly
706 requested with \f[CR]CleanPackageManagerMetadata=yes\f[R] when building
707 \f[CR]directory\f[R] and \f[CR]tar\f[R] images.
708 .SS v20.2
709 .IP \[bu] 2
710 Fixed a bug in signing unsigned shim EFI binaries.
711 .IP \[bu] 2
712 We now build an early microcode initrd in the mkosi kernel\-install
713 plugin.
714 .IP \[bu] 2
715 Added \f[CR]PackageDirectories=\f[R] to allow providing extra packages
716 to be made available during the build.
717 .IP \[bu] 2
718 Fixed issue where \f[CR]KernelModulesIncludeHost\f[R] was including
719 unnecessary modules
720 .IP \[bu] 2
721 Fixed \f[CR]\-\-mirror\f[R] specification for CentOS (and variants) and
722 Fedora.
723 Previously a subdirectory within the mirror had to be specified which
724 prevented using CentOS and EPEL repositories from the same mirror.
725 Now only the URL has be specified.
726 .IP \[bu] 2
727 We now mount package manager cache directories when running scripts on
728 the host so that any packages installed in scripts are properly cached.
729 .IP \[bu] 2
730 We don\[cq]t download filelists on Fedora anymore
731 .IP \[bu] 2
732 Nested build sources don\[cq]t cause errors anymore when trying to
733 install packages.
734 .IP \[bu] 2
735 We don\[cq]t try to build the same tools tree more than once anymore
736 when building multiple images.
737 .IP \[bu] 2
738 We now create the \f[CR]/etc/mtab\f[R] compatibility symlink in
739 mkosi\[cq]s sandbox.
740 .IP \[bu] 2
741 We now always hash the root password ourselves instead of leaving it to
742 \f[CR]systemd\-firstboot\f[R].
743 .IP \[bu] 2
744 \f[CR]/srv\f[R] and \f[CR]/mnt\f[R] are not mounted read\-only anymore
745 during builds.
746 .IP \[bu] 2
747 Fixed a crash when running mkosi in a directory with fewer than two
748 parent directories.
749 .IP \[bu] 2
750 Implemented \f[CR]RepositoryKeyCheck=\f[R] for apt\-based distributions.
751 .SS v20.1
752 .IP \[bu] 2
753 \f[CR]BuildSources=\f[R] are now mounted when we install packages so
754 local packages can be made available in the sandbox.
755 .IP \[bu] 2
756 Fixed check to see if we\[cq]re running as root which makes sure we
757 don\[cq]t do shared mounts when running as root.
758 .IP \[bu] 2
759 The extension release file is now actually written when building system
760 or configuration extensions.
761 .IP \[bu] 2
762 The nspawn settings are copied to the output directory again.
763 .IP \[bu] 2
764 Incremental caching is now skipped when \f[CR]Overlay=\f[R] is enabled
765 as this combination isn\[cq]t supported.
766 .IP \[bu] 2
767 The SELinux relabel check is more granular and now checks for all
768 required files instead of just whether there\[cq]s a policy configured.
769 .IP \[bu] 2
770 \f[CR]qemu\-system\-xxx\f[R] binaries are now preferred over the generic
771 \f[CR]qemu\f[R] and \f[CR]qemu\-kvm\f[R] binaries.
772 .IP \[bu] 2
773 Grub tools from the tools tree are now used to install grub instead of
774 grub tools from the image itself.
775 The grub tools were added to the default tools trees as well.
776 .IP \[bu] 2
777 The pacman keyring in tools trees is now only populated from the Arch
778 Linux keyring (and not the Debian/Ubuntu ones anymore).
779 .IP \[bu] 2
780 \f[CR]gpg\f[R] is allowed to access \f[CR]/run/pscsd/pscsd.comm\f[R] on
781 the host if it exists to allow interaction with smartcards.
782 .SS v20
783 .IP \[bu] 2
784 The current working directory is not mounted unconditionally to
785 \f[CR]/work/src\f[R] anymore.
786 Instead, the default value for \f[CR]BuildSources=\f[R] now mounts the
787 current working directory to \f[CR]/work/src\f[R].
788 This means that the current working directory is no longer implicitly
789 included when \f[CR]BuildSources=\f[R] is explicitly configured.
790 .IP \[bu] 2
791 Assigning the empty string to a setting that takes a list of values now
792 overrides any configured default value as well.
793 .IP \[bu] 2
794 The github action does not build and install systemd from source
795 anymore.
796 Instead, \f[CR]ToolsTree=default\f[R] can be used to make sure a recent
797 version of systemd is used to do the image build.
798 .IP \[bu] 2
799 Added \f[CR]EnvironmentFiles=\f[R] to read environment variables from
800 environment files.
801 .IP \[bu] 2
802 We drastically reduced how much of the host system we expose to scripts.
803 Aside from \f[CR]/usr\f[R], a few directories in \f[CR]/etc\f[R],
804 \f[CR]/tmp\f[R], \f[CR]/var/tmp\f[R] and various directories configured
805 in mkosi settings, all host directories are hidden from scripts, package
806 managers and other tools executed by mkosi.
807 .IP \[bu] 2
808 Added \f[CR]RuntimeScratch=\f[R] to automatically mount a directory with
809 extra scratch space into mkosi\-spawned containers and virtual machines.
810 .IP \[bu] 2
811 Package manager trees can now be used to configure every tool invoked by
812 mkosi while building an image that reads config files from
813 \f[CR]/etc\f[R] or \f[CR]/usr\f[R].
814 .IP \[bu] 2
815 Added \f[CR]SELinuxRelabel=\f[R] to specify whether to relabel selinux
816 files or not.
817 .IP \[bu] 2
818 Many fixes to tools trees were made and tools trees are now covered by
819 .RS 2
820 .IP "CI." 4
821 Some combinations aren\[cq]t possible yet but we\[cq]re actively working
822 to make these possible.
823 .RE
824 .IP \[bu] 2
825 \f[CR]mkosi qemu\f[R] now supports direct kernel boots of
826 \f[CR]s390x\f[R] and \f[CR]powerpc\f[R] images.
827 .IP \[bu] 2
828 Added \f[CR]HostArchitecture=\f[R] match to match against the host
829 architecture.
830 .IP \[bu] 2
831 We don\[cq]t use the user\[cq]s SSH public/private keypair anymore for
832 \f[CR]mkosi ssh\f[R] but instead use a separate key pair which can be
833 generated by \f[CR]mkosi genkey\f[R].
834 Users using \f[CR]mkosi ssh\f[R] will have to run
835 \f[CR]mkosi genkey\f[R] once to generate the necessary files to keep
836 \f[CR]mkosi ssh\f[R] working.
837 .IP \[bu] 2
838 We don\[cq]t automatically set \f[CR]\-\-offline=no\f[R] anymore when we
839 detect the \f[CR]Subvolumes=\f[R] setting is used in a
840 \f[CR]systemd\-repart\f[R] partition definition file.
841 Instead, use the new \f[CR]RepartOffline=\f[R] option to explicitly
842 disable running \f[CR]systemd\-repart\f[R] in offline mode.
843 .IP \[bu] 2
844 During the image build we now install UKIs/kernels/initrds to
845 \f[CR]/boot\f[R] instead of \f[CR]/efi\f[R].
846 While this will generally not be noticeable, users with custom
847 systemd\-repart ESP partition definitions will need to add
848 \f[CR]CopyFiles=/boot:/\f[R] along with the usual
849 \f[CR]CopyFiles=/efi:/\f[R] to their ESP partition definitions.
850 By installing UKIs/kernels/initrds to \f[CR]/boot\f[R], it becomes
851 possible to use \f[CR]/boot\f[R] to populate an XBOOTLDR partition which
852 wasn\[cq]t possible before.
853 Note that this is also safe to do before \f[CR]v20\f[R] so
854 \f[CR]CopyFiles=/boot:/\f[R] can unconditionally be added to any ESP
855 partition definition files.
856 .IP \[bu] 2
857 Added \f[CR]QemuFirmwareVariables=\f[R] to allow specifying a custom
858 OVMF variables file to use.
859 .IP \[bu] 2
860 Added \f[CR]MinimumVersion=\f[R] to allow specifying the minimum
861 required mkosi version to build an image.
862 .IP \[bu] 2
863 Added support for Arch Linux\[cq]s debug repositories.
864 .IP \[bu] 2
865 Merged the mkosi\-initrd project into mkosi itself.
866 mkosi\-initrd is now used to build the default initrd.
867 .IP \[bu] 2
868 Implemented mkosi\-initrd for all supported distributions.
869 .IP \[bu] 2
870 Added \f[CR]ShimBootloader=\f[R] to support installing shim to the ESP.
871 .IP \[bu] 2
872 Added sysext, confext and portable output formats.
873 These will produce signed disk images that can be used as sysexts,
874 confexts and portable services respectively.
875 .IP \[bu] 2
876 Added \f[CR]QemuVsockConnectionId=\f[R] to configure how to allocate the
877 vsock connection ID when \f[CR]QemUVsock=\f[R] is enabled.
878 .IP \[bu] 2
879 Added documentation on how to build sysexts with mkosi.
880 .IP \[bu] 2
881 Global systemd user presets are now also configured.
882 .IP \[bu] 2
883 Implemented \f[CR]WithDocs=\f[R] for \f[CR]apt\f[R].
884 .IP \[bu] 2
885 On supported package managers, locale data for other locales is now
886 stripped if the local is explicitly configured using \f[CR]Locale=\f[R].
887 .IP \[bu] 2
888 All \f[CR]rpm\f[R] plugins are now disabled when building images.
889 .IP \[bu] 2
890 Added \f[CR]KernelModulesIncludeHost=\f[R] and
891 \f[CR]KernelModulesInitrdIncludeHost=\f[R] to only include modules
892 loaded on the host system in the image/initrd respectively.
893 .IP \[bu] 2
894 Implemented \f[CR]RemovePackages=\f[R] for Arch Linux.
895 .IP \[bu] 2
896 Added \f[CR]useradd\f[R] and \f[CR]groupadd\f[R] scripts to configure
897 these binaries to operate on the image during builds instead on the
898 host.
899 .IP \[bu] 2
900 Added microcode support.
901 If installed into the image, an early microcode initrd will
902 automatically be built and prepended to the initrd.
903 .IP \[bu] 2
904 A passwordless root account may now be created by specifying
905 \f[CR]hashed:\f[R].
906 .IP \[bu] 2
907 The \f[CR]Autologin=\f[R] feature was extended with support for
908 \f[CR]arm64\f[R], \f[CR]s390x\f[R] and \f[CR]powerpc\f[R] architectures.
909 .IP \[bu] 2
910 Added \f[CR]SecureBootAutoEnroll=\f[R] to control automatic enrollment
911 of secureboot keys separately from signing \f[CR]systemd\-boot\f[R] and
912 generated UKIs.
913 .IP \[bu] 2
914 \f[CR]ImageVersion=\f[R] is no longer automatically appended to the
915 output files, instead this is automatically appended to
916 \f[CR]Output=\f[R] if not specified and results in the \f[CR]%o\f[R]
917 specifier being equivalent to \f[CR]%i\f[R] or \f[CR]%i_%v\f[R]
918 depending on whether \f[CR]ImageVersion=\f[R] is specified.
919 .SS v19
920 .IP \[bu] 2
921 Support for RHEL was added!
922 .IP \[bu] 2
923 Added \f[CR]journalctl\f[R] and \f[CR]coredumpctl\f[R] verbs for running
924 the respective tools on built directory or disk images.
925 .IP \[bu] 2
926 Added a \f[CR]burn\f[R] verb to write the output image to a block
927 device.
928 .IP \[bu] 2
929 Added a new \f[CR]esp\f[R] output format, which is largely similar to
930 the existing \f[CR]uki\f[R] output format but wraps it in a disk image
931 with only an ESP.
932 .IP \[bu] 2
933 \f[CR]Presets\f[R] were renamed to \f[CR]Images\f[R].
934 \f[CR]mkosi.images/\f[R] is now used instead of
935 \f[CR]mkosi.presets/\f[R], the \f[CR]Presets=\f[R] setting was renamed
936 to \f[CR]Images=\f[R] and the \f[CR]Presets\f[R] section was merged into
937 the \f[CR]Config\f[R] section.
938 The old names can still be used for backwards compatibility.
939 .IP \[bu] 2
940 Added profiles to support building variants of the same image in one
941 repository.
942 Profiles can be defined in \f[CR]mkosi.profiles/\f[R] and one can be
943 selected using the new \f[CR]Profile=\f[R] setting.
944 .IP \[bu] 2
945 mkosi will now parse \f[CR]mkosi.local.conf\f[R] before any other config
946 files if that exists.
947 .IP \[bu] 2
948 Added a kernel\-install plugin.
949 This is only shipped in source tree and not included in the Python
950 module.
951 .IP \[bu] 2
952 Added a \f[CR]\-\-json\f[R] option to get the output of
953 \f[CR]mkosi summary\f[R] as JSON.
954 .IP \[bu] 2
955 Added shorthand \f[CR]\-a\f[R] for \f[CR]\-\-autologin\f[R].
956 .IP \[bu] 2
957 Added a \f[CR]\-\-debug\-workspace\f[R] option to not remove the
958 workspace directory after a build.
959 This is useful to inspect the workspace after failing builds.
960 As a consequence the prefix for the default workspace directory prefix
961 has been changed from \f[CR].mkosi\-tmp\f[R] to
962 \f[CR]mkosi\-workspace\f[R].
963 .IP \[bu] 2
964 Scripts with the \f[CR].chroot\f[R] extension are now executed in the
965 image automatically.
966 .IP \[bu] 2
967 Added \f[CR]rpm\f[R] helper script to have \f[CR]rpm\f[R] automatically
968 operate on the image when running scripts.
969 .IP \[bu] 2
970 Added \f[CR]mkosi\-as\-caller\f[R] helper script that can be used in
971 scripts to run commands as the user invoking mkosi.
972 .IP \[bu] 2
973 \f[CR]mkosi\-chroot\f[R] will now start a shell if no arguments are
974 specified.
975 .IP \[bu] 2
976 Added \f[CR]WithRecommends=\f[R] to configure whether to install
977 recommended packages by default or not where this is supported.
978 It is disabled by default.
979 .IP \[bu] 2
980 Added \f[CR]ToolsTreeMirror=\f[R] setting for configuring the mirror to
981 use for the default tools tree.
982 .IP \[bu] 2
983 \f[CR]WithDocs=\f[R] is now enabled by default.
984 .IP \[bu] 2
985 Added \f[CR]BuildSourcesEphemeral=\f[R] to make source directories
986 ephemeral when running scripts.
987 This means any changes made to source directories while running scripts
988 will be undone after the scripts have finished executing.
989 .IP \[bu] 2
990 Added \f[CR]QemuDrives=\f[R] to have mkosi create extra qemu drives and
991 pass them to qemu when using the \f[CR]qemu\f[R] verb.
992 .IP \[bu] 2
993 Added \f[CR]BuildSources=\f[R] match to match against configured build
994 source targets.
995 .IP \[bu] 2
996 \f[CR]PackageManagerTrees=\f[R] was moved to the \f[CR]Distribution\f[R]
997 section.
998 .IP \[bu] 2
999 We now automatically configure the qemu firmware, kernel cmdline and
1000 initrd based on what type of kernel is passed by the user via
1001 \f[CR]\-kernel\f[R] or \f[CR]QemuKernel=\f[R].
1002 .IP \[bu] 2
1003 The mkosi repository itself now ships configuration to build basic
1004 bootable images that can be used to test mkosi.
1005 .IP \[bu] 2
1006 Added support for enabling \f[CR]updates\-testing\f[R] repositories for
1007 Fedora.
1008 .IP \[bu] 2
1009 GPG keys for CentOS, Fedora, Alma and Rocky are now looked up locally
1010 first before fetching them remotely.
1011 .IP \[bu] 2
1012 Signatures are not required for local packages on Arch anymore.
1013 .IP \[bu] 2
1014 Packages on opensuse are now always downloaded in advance before
1015 installation when using zypper.
1016 .IP \[bu] 2
1017 The tar output is now reproducible.
1018 .IP \[bu] 2
1019 We now make sure \f[CR]git\f[R] can be executed from mkosi scripts
1020 without running into permission errors.
1021 .IP \[bu] 2
1022 We don\[cq]t create subdirectories beneath the configured cache
1023 directory anymore.
1024 .IP \[bu] 2
1025 Workspace directories are now created outside of any source directories.
1026 mkosi will either use \f[CR]XDG_CACHE_HOME\f[R], \f[CR]$HOME/.cache\f[R]
1027 or \f[CR]/var/tmp\f[R] depending on the situation.
1028 .IP \[bu] 2
1029 Added environment variable \f[CR]MKOSI_DNF\f[R] to override which dnf to
1030 use for building images (\f[CR]dnf\f[R] or \f[CR]dnf5\f[R]).
1031 .IP \[bu] 2
1032 The rootfs can now be modified when running build scripts (with all
1033 changes thrown away after the last build script has been executed).
1034 .IP \[bu] 2
1035 mkosi now fails if configuration specified via the CLI does not apply to
1036 any image (because it is overridden).
1037 .IP \[bu] 2
1038 Added a new doc on building rpms from source with mkosi
1039 (\f[CR]docs/building\-rpms\-from\-source.md\f[R]).
1040 .IP \[bu] 2
1041 \f[CR]/etc/resolv.conf\f[R] will now only be mounted for scripts when
1042 they are run with network access.
1043 .SS v18
1044 .IP \[bu] 2
1045 \f[CR]$SCRIPT\f[R] was renamed to \f[CR]$CHROOT_SCRIPT\f[R].
1046 \f[CR]$SCRIPT\f[R] can still be used but is considered deprecated.
1047 .IP \[bu] 2
1048 Added \f[CR]RuntimeTrees=\f[R] setting to mount directories when booting
1049 images via \f[CR]mkosi boot\f[R], \f[CR]mkosi shell\f[R] or
1050 \f[CR]mkosi qemu\f[R].
1051 The directories are mounted with a uid map that maps the user invoking
1052 mkosi to the root user so that all files in the directory appear as if
1053 owned by the root user in the container or virtual machine and any new
1054 files created in the directories are owned by the user invoking mkosi.
1055 To make this work in VMs, we use \f[CR]VirtioFS\f[R] via
1056 \f[CR]virtiofsd\f[R].
1057 Note that this requires systemd v254 or newer to be installed in the
1058 image.
1059 .IP \[bu] 2
1060 Added support for booting directory images with \f[CR]mkosi qemu\f[R]
1061 via \f[CR]VirtioFS\f[R].
1062 When \f[CR]CONFIG_VIRTIOFS\f[R] and \f[CR]CONFIG_VIRTIO_PCI\f[R] are
1063 builtin modules, no initramfs is required to make this work.
1064 .IP \[bu] 2
1065 Added \f[CR]Include=\f[R] or \f[CR]\-\-include\f[R] to include extra
1066 configuration files or directories.
1067 .IP \[bu] 2
1068 Added support for specifiers to access the current value of certain
1069 settings during configuration file parsing.
1070 .IP \[bu] 2
1071 \f[CR]mkosi\f[R] will now exit with an error when no configuration was
1072 provided.
1073 .IP \[bu] 2
1074 Multiple scripts of the same type are now supported.
1075 .IP \[bu] 2
1076 Custom distributions are now supported via the new \f[CR]custom\f[R]
1077 distribution.
1078 When using \f[CR]custom\f[R] as the distribution, the rootfs must be
1079 provided via base trees, skeleton trees or prepare scripts.
1080 .IP \[bu] 2
1081 We now use local GPG keys for rpm based distributions if the
1082 \f[CR]distribution\-gpg\-keys\f[R] package is installed on the host.
1083 .IP \[bu] 2
1084 Added \f[CR]RuntimeSize=\f[R] to grow the image to a specific size
1085 before booting it when using \f[CR]mkosi boot\f[R] or
1086 \f[CR]mkosi qemu\f[R].
1087 .IP \[bu] 2
1088 We now set \f[CR]MKOSI_UID\f[R] and \f[CR]MKOSI_GID\f[R] when running
1089 scripts which are set to the uid and gid of the user invoking mkosi
1090 respectively.
1091 These can be used to run commands as the user that invoked mkosi.
1092 .IP \[bu] 2
1093 Added an \f[CR]Architecture=\f[R] match
1094 .IP \[bu] 2
1095 Initrds specified with \f[CR]Initrds=\f[R] are now used for grub
1096 menuentries as well.
1097 .IP \[bu] 2
1098 \f[CR]ImageId=\f[R] and \f[CR]ImageVersion=\f[R] are now written to
1099 os\-release as \f[CR]IMAGE_ID\f[R] and \f[CR]IMAGE_VERSION\f[R] if
1100 provided.
1101 .IP \[bu] 2
1102 We pass command line arguments passed to the \f[CR]build\f[R] verb to
1103 the build script again.
1104 .IP \[bu] 2
1105 We added support for the \[lq]RHEL Universal Base Image\[rq]
1106 distribution.
1107 .SS v17.1
1108 .IP \[bu] 2
1109 Fixed bug where \f[CR]\-\-autologin\f[R] was broken when used in
1110 combination with a tools tree when using a packaged version of mkosi.
1111 .SS v17
1112 .IP \[bu] 2
1113 Added \f[CR]ToolsTreePackages=\f[R] to add extra packages to the default
1114 tools tree.
1115 .IP \[bu] 2
1116 Added \f[CR]SystemdVersion=\f[R] match to match on the host\[cq]s
1117 systemd version
1118 .IP \[bu] 2
1119 Added \f[CR]Format=\f[R] match to match on the configured output format
1120 .IP \[bu] 2
1121 \f[CR]Presets=\f[R] can now be configured in global configuration files
1122 to select which presets to build
1123 .IP \[bu] 2
1124 UKIs can now be booted using direct linux boot.
1125 .IP \[bu] 2
1126 We don\[cq]t try to make images UEFI bootable anymore on architectures
1127 that do not support UEFI
1128 .IP \[bu] 2
1129 Fixed \f[CR]\-\-help\f[R] to show all options again
1130 .IP \[bu] 2
1131 We now warn when settings are configured in the wrong section
1132 .SS v16
1133 .IP \[bu] 2
1134 \f[CR]mkosi.version\f[R] is now picked up from preset and dropin
1135 directories as well following the usual config precedence logic
1136 .IP \[bu] 2
1137 Removed the \[lq]first assignment wins\[rq] logic from configuration
1138 parsing.
1139 Settings parsed later will now override earlier values
1140 .IP \[bu] 2
1141 Removed the \f[CR]!\f[R] operator for lists.
1142 Instead, assign the empty string to the list to remove all previous
1143 values.
1144 .IP \[bu] 2
1145 Added support for configuring custom default values for settings by
1146 prefixing their name in the configuration file with \f[CR]\[at]\f[R].
1147 .IP \[bu] 2
1148 Added \f[CR]QemuCdrom=\f[R] to attach the image to the virtual machine
1149 as a CD\-ROM instead of a block device.
1150 .IP \[bu] 2
1151 Added \f[CR]SectorSize=\f[R] to set the sector size of the disk images
1152 built by systemd\-repart.
1153 .IP \[bu] 2
1154 Added back grub support (BIOS/UEFI).
1155 Note that we don\[cq]t install grub on UEFI yet but we do add the
1156 necessary configuration and partitions.
1157 .IP \[bu] 2
1158 Added \f[CR]Bootloader=\f[R] option to configure which EFI bootloader to
1159 install.
1160 Added \f[CR]uki\f[R] option to install just the UKI without
1161 systemd\-boot and \f[CR]grub\f[R] to generate grub configuration to
1162 chainload into the built UKIs.
1163 .IP \[bu] 2
1164 Added \f[CR]BiosBootloader=\f[R] to configure whether grub for BIOS gets
1165 installed or not.
1166 .IP \[bu] 2
1167 Added \f[CR]QemuFirmware=\f[R] to select which qemu firmware to use
1168 (OVMF, Seabios or direct kernel boot).
1169 .IP \[bu] 2
1170 Added \f[CR]QemuKernel=\f[R] to specify the kernel that should be used
1171 with direct kernel boot.
1172 .IP \[bu] 2
1173 \f[CR]/var/lib/dbus/machine\-id\f[R] is now removed if it was added by a
1174 package manager postinstall script.
1175 .IP \[bu] 2
1176 The manifest is not generated by default anymore.
1177 Use \f[CR]ManifestFormat=json\f[R] to make sure the manifest is
1178 generated.
1179 .IP \[bu] 2
1180 Added \f[CR]SourceDateEpoch=\f[R] to enable more reproducible image
1181 builds.
1182 .IP \[bu] 2
1183 Added \f[CR]Seed=\f[R] to set the seed passed to systemd\-repart.
1184 .IP \[bu] 2
1185 Updated the default Fedora release to Fedora 39.
1186 .IP \[bu] 2
1187 If \f[CR]ToolsTree=\f[R] is set to \f[CR]default\f[R], mkosi will now
1188 build a default tools tree containing all the necessary tools to build
1189 images.
1190 The distribution and release to use can be configured with
1191 \f[CR]ToolsTreeDistribution=\f[R] and \f[CR]ToolsTreeRelease=\f[R] or
1192 are determined automatically based on the image being built.
1193 .IP \[bu] 2
1194 Added \f[CR]uki\f[R] output format.
1195 This is similar to \f[CR]cpio\f[R], except the cpio is packaged up as a
1196 UKI with a kernel image and stub picked up from the rootfs.
1197 .SS v15.1
1198 .IP \[bu] 2
1199 The man page can be generated from the markdown file via
1200 \f[CR]tools/make\-man\-page.sh\f[R].
1201 .IP \[bu] 2
1202 Fixed issue where not all packages and data files where included in the
1203 generated python package.
1204 .IP \[bu] 2
1205 mkosi doesn\[cq]t try to unshare the network namespace anymore when it
1206 doesn\[cq]t have \f[CR]CAP_NET_ADMIN\f[R].
1207 .IP \[bu] 2
1208 Fixed issue when the workspace was located in \f[CR]/tmp\f[R].
1209 .IP \[bu] 2
1210 Don\[cq]t try to run \f[CR]timedatectl\f[R] or \f[CR]ssh\-add\f[R] when
1211 they\[cq]re not installed.
1212 .SS v15
1213 .IP \[bu] 2
1214 Migrated to systemd\-repart.
1215 Many options are dropped in favor of specifying them directly in repart
1216 partition definition files:
1217 .RS 2
1218 .IP \[bu] 2
1219 Format=gpt_xxx options are replaced with a single \[lq]disk\[rq]
1220 options.
1221 Filesystem to use can now be specified with repart\[cq]s Format= option
1222 .IP \[bu] 2
1223 Format=plain_squashfs (Can be reproduced by a single repart squashfs
1224 root partition combined with SplitArtifacts=yes)
1225 .IP \[bu] 2
1226 Verity= (Replaced by repart\[cq]s Verity= options)
1227 .IP \[bu] 2
1228 Encrypt= (Replaced by repart\[cq]s Encrypt= option)
1229 .IP \[bu] 2
1230 RootSize=, HomeSize=, VarSize=, TmpSize=, ESPSize=, SwapSize=, SrvSize=
1231 (Replaced by repart\[cq]s size options)
1232 .IP \[bu] 2
1233 UsrOnly= (replaced with \f[CR]CopyFiles=/:/usr\f[R] in a usr partition
1234 definition)
1235 .IP \[bu] 2
1236 OutputSplitRoot=, OutputSplitVerity=, (Replaced by repart\[cq]s
1237 SplitName= option)
1238 .IP \[bu] 2
1239 OutputSplitKernel= (UKI is now always written to its own output file)
1240 .IP \[bu] 2
1241 GPTFirstLBA (Removed, no equivalent in repart)
1242 .IP \[bu] 2
1243 ReadOnly= (Replaced by repart\[cq]s ReadOnly= option per partition)
1244 .IP \[bu] 2
1245 Minimize= (Replaced by repart\[cq]s Minimize= option per partition)
1246 .IP \[bu] 2
1247 CompressFs= (No equivalent in repart, can be replicated by replacing
1248 mkfs.
1249 in $PATH with a script that adds the necessary command line option)
1250 .IP \[bu] 2
1251 MkSquashfs= (Can be replaced with a script in $PATH that invokes the
1252 correct binary)
1253 .PP
1254 We also remove the WithoutUnifiedKernelImages= switch as building
1255 unified kernel images is trivial and fast these days.
1256 .RE
1257 .IP \[bu] 2
1258 Support for \[en]qemu\-boot was dropped
1259 .IP \[bu] 2
1260 Support for \[en]use\-host\-repositories was dropped, use
1261 \[en]repository\-directory instead
1262 .IP \[bu] 2
1263 \f[CR]RepositoryDirectory\f[R] was removed, use
1264 \f[CR]PackageManagerTrees=\f[R] or \f[CR]SkeletonTrees=\f[R] instead.
1265 .IP \[bu] 2
1266 \f[CR]\-\-repositories\f[R] is now only usable on Debian/RPM based
1267 distros and can only be used to enable additional repositories.
1268 Specifically, it cannot be used on Arch Linux anymore to add new
1269 repositories.
1270 .IP \[bu] 2
1271 The \f[CR]_epel\f[R] distributions were removed.
1272 Use \f[CR]\-\-repositories=epel\f[R] instead to enable the EPEL
1273 repository.
1274 .IP \[bu] 2
1275 Removed \f[CR]\-stream\f[R] from CentOS release specifiers.
1276 Instead of specifying \f[CR]8\-stream\f[R], you know just specify
1277 \f[CR]8\f[R].
1278 .IP \[bu] 2
1279 Removed default kernel command line arguments \f[CR]rhgb\f[R],
1280 \f[CR]selinux=0\f[R] and \f[CR]audit=0\f[R].
1281 .IP \[bu] 2
1282 Dropped \[en]all and \[en]all\-directory as this functionality is better
1283 implemented by using a build system.
1284 .IP \[bu] 2
1285 mkosi now builds images without needing root privileges.
1286 .IP \[bu] 2
1287 Removed \f[CR]\-\-no\-chown\f[R], \f[CR]\-\-idmap\f[R] and
1288 \f[CR]\-\-nspawn\-keep\-unit\f[R] options as they were made obsolete by
1289 moving to rootless builds.
1290 .IP \[bu] 2
1291 Removed \f[CR]\-\-source\-file\-transfer\f[R],
1292 \f[CR]\-\-source\-file\-transfer\-final\f[R],
1293 \f[CR]\-\-source\-resolve\-symlinks\f[R] and
1294 \f[CR]\-\-source\-resolve\-symlinks\-final\f[R] in favor of always
1295 mounting the source directory into the build image.
1296 \f[CR]\-\-source\-file\-transfer\-final\f[R] might be reimplemented in
1297 the future using virtiofsd.
1298 .IP \[bu] 2
1299 Dropped \f[CR]\-\-include\-dir\f[R] option.
1300 Usage can be replaced by using \f[CR]\-\-incremental\f[R] and reading
1301 includes from the cached build image tree.
1302 .IP \[bu] 2
1303 Removed \f[CR]\-\-machine\-id\f[R] in favor of shipping images without a
1304 machine ID at all.
1305 .IP \[bu] 2
1306 Removed \f[CR]\-\-skip\-final\-phase\f[R] as we only have a single phase
1307 now.
1308 .IP \[bu] 2
1309 The post install script is only called for the final image now and not
1310 for the build image anymore.
1311 Use the prepare script instead.
1312 .IP \[bu] 2
1313 \f[CR]\-\-ssh\-key\f[R], \f[CR]\-\-ssh\-agent\f[R],
1314 \f[CR]\-\-ssh\-port\f[R] and \f[CR]\-\-ssh\-timeout\f[R] options were
1315 dropped as the SSH support was reimplemented using VSock.
1316 \f[CR]mkosi ssh\f[R] can only be used with images booted with
1317 \f[CR]mkosi qemu\f[R].
1318 Use \f[CR]machinectl\f[R] to access images booted with
1319 \f[CR]mkosi boot\f[R].
1320 Use \[en]extra\-tree or \[en]credential with the
1321 \f[CR].ssh.authorized_keys.root\f[R] credentials as alternatives for
1322 provisioning the public key inside the image.
1323 .IP \[bu] 2
1324 Only configuration files matching \f[CR]*.conf\f[R] are parsed in dropin
1325 directories now.
1326 .IP \[bu] 2
1327 Removed \f[CR]\-\-qemu\-headless\f[R], we now start qemu in the terminal
1328 by default and configure the serial console at runtime.
1329 Use the new \f[CR]\-\-qemu\-gui\f[R] option to start qemu in its
1330 graphical interface.
1331 .IP \[bu] 2
1332 Removed \f[CR]\-\-netdev\f[R].
1333 Can be replaced by manually installing systemd\-networkd, putting a
1334 network file in the image and enabling systemd\-networkd.
1335 .IP \[bu] 2
1336 If \f[CR]mkosi.extra/\f[R] or \f[CR]mkosi.skeleton/\f[R] exist, they are
1337 now always used instead of only when no explicit extra/skeleton trees
1338 are defined.
1339 .IP \[bu] 2
1340 mkosi doesn\[cq]t install any default packages anymore aside from
1341 packages required by the distro or the base filesystem layout package if
1342 there are no required packages.
1343 In practice, this means systemd and other basic tools have to be
1344 installed explicitly from now on.
1345 .IP \[bu] 2
1346 Removed \f[CR]\-\-base\-packages\f[R] as it\[cq]s not needed anymore
1347 since we don\[cq]t install any packages by default anymore aside from
1348 the base filesystem layout package.
1349 .IP \[bu] 2
1350 Removed \f[CR]\-\-qcow2\f[R] option in favor of supporting only raw disk
1351 images as the disk image output format.
1352 .IP \[bu] 2
1353 Removed \f[CR]\-\-bmap\f[R] option as it can be trivially added manually
1354 by utilizing a finalize script.
1355 .IP \[bu] 2
1356 The \f[CR]never\f[R] value for \f[CR]\-\-with\-network\f[R] was spun of
1357 into its own custom option \f[CR]\-\-cache\-only\f[R].
1358 .IP \[bu] 2
1359 \f[CR]\-\-bootable\f[R] now defaults to \f[CR]auto\f[R].
1360 When set to \f[CR]auto\f[R], mkosi will generate a bootable image only
1361 if all the necessary packages are installed.
1362 Documentation was added in docs/bootable.md on how a bootable image can
1363 be generated on mainstream distros.
1364 .IP \[bu] 2
1365 The RPM db is no longer rebuilt in bdb format on CentOS Stream 8.
1366 To be able to install packages on a CentOS Stream 8 image with a RPM db
1367 in sqlite format, rewrite the db in bdb format using
1368 \f[CR]rpm \-\-rebuilddb \-\-define _db_backend bdb\f[R].
1369 .IP \[bu] 2
1370 Repositories are now only written to /etc/apt/sources.list if apt is
1371 installed in the image.
1372 .IP \[bu] 2
1373 Removed the dependency on \f[CR]debootstrap\f[R] to build Ubuntu or
1374 Debian images.
1375 .IP \[bu] 2
1376 Apt now uses the keyring from the host instead of the keyring from the
1377 image.
1378 This means \f[CR]debian\-archive\-keyring\f[R] or
1379 \f[CR]ubuntu\-archive\-keyring\f[R] are now required to be installed to
1380 build Debian or Ubuntu images respectively.
1381 .IP \[bu] 2
1382 \f[CR]\-\-base\-image\f[R] is split into \f[CR]\-\-base\-tree\f[R] and
1383 \f[CR]\-\-overlay\f[R].
1384 .IP \[bu] 2
1385 Removed \f[CR]\-\-cache\-initrd\f[R], instead, use a prebuilt initrd
1386 with \f[CR]Initrds=\f[R] to avoid rebuilding the initrd all the time.
1387 .IP \[bu] 2
1388 Disk images are now resized to 8G when booted to give some disk space to
1389 play around with in the booted image.
1390 .IP \[bu] 2
1391 Removed \f[CR]\-\-install\-directory=\f[R] option.
1392 This was originally added for caching the installation results, but this
1393 doesn\[cq]t work properly as it might result in leftover files in the
1394 install directory from a previous installation, so we have to empty the
1395 directory before reusing it, invalidating the caching, so the option was
1396 removed.
1397 .IP \[bu] 2
1398 Build scripts are now executed on the host.
1399 See the \f[CR]SCRIPTS\f[R] section in the manual for more information.
1400 Existing build scripts will need to be updated to make sure they keep
1401 working.
1402 Specifically, most paths in scripts will need to be prefixed with
1403 $BUILDROOT to have them operate on the image instead of on the host
1404 system.
1405 To ensure the host system cannot be modified when running a script, most
1406 host directories are mounted read\-only when running a script to ensure
1407 a script cannot modify the host in any way.
1408 Alternatively to making the script run on the host, the script can also
1409 still be executed in the image itself by putting the following snippet
1410 at the top of the script:
1411 .RS 2
1412 .IP
1413 .EX
1414 if [ \[dq]$container\[dq] != \[dq]mkosi\[dq] ]; then
1415 exec mkosi\-chroot \[dq]$SCRIPT\[dq] \[dq]$\[at]\[dq]
1416 fi
1417 .EE
1418 .RE
1419 .IP \[bu] 2
1420 Removed \f[CR]\-\-tar\-strip\-selinux\-context=\f[R] option.
1421 We now label all files properly if selinux is enabled and if users
1422 don\[cq]t want the labels, they can simply exclude them when extracting
1423 the archive.
1424 .IP \[bu] 2
1425 Gentoo is now marked as experimental and unsupported and there\[cq]s no
1426 guarantee at all that it will work.
1427 Issues related to gentoo will generally not receive attention from core
1428 maintainers.
1429 All gentoo specific hacks outside of the gentoo implementation module
1430 have been removed.
1431 .IP \[bu] 2
1432 A verb \f[CR]documentation\f[R] has been added.
1433 Calling mkosi with this verb will show the documentation.
1434 This is useful when running mkosi during development to always have the
1435 documentation in the correct version available.
1436 By default it will try several ways to output the documentation, but a
1437 specific option can be chosen with the \f[CR]\-\-doc\-format\f[R]
1438 option.
1439 Distro packagers are encouraged to add a file \f[CR]mkosi.1\f[R] into
1440 the \f[CR]mkosi/resources\f[R] directory of the Python package, if it is
1441 missing, as well es install it in the appropriate search path for man
1442 pages.
1443 The man page can be generated from the markdown file
1444 \f[CR]mkosi/resources/mkosi.md\f[R] e.g via
1445 \f[CR]pandoc \-t man \-s \-o mkosi.1 mkosi.md\f[R].
1446 .IP \[bu] 2
1447 BuildSources= now takes source:target pairs which specify the source
1448 directory and where to mount it relative to the top level source
1449 directory when running scripts.
1450 (e.g.\ BuildSources=../my\-project:my\-project)
1451 .SS v14
1452 .IP \[bu] 2
1453 Support for Clear Linux was dropped.
1454 See https://github.com/systemd/mkosi/pull/1037 for more information.
1455 .IP \[bu] 2
1456 Support for Photon was dropped.
1457 See https://github.com/systemd/mkosi/pull/1048 for more information.
1458 .IP \[bu] 2
1459 The Arch kernel/bootloader pacman hooks were removed.
1460 For anyone that still wants to use them, they can be found \c
1461 .UR https://github.com/systemd/mkosi/tree/v13/mkosi/resources/arch
1462 here
1463 .UE \c
1464 \&.
1465 .IP \[bu] 2
1466 mkosi now creates \f[CR]distro\[ti]release\f[R] subdirectories inside
1467 the build, cache and output directories for each
1468 \f[CR]distro\[ti]release\f[R] combination that is built.
1469 This allows building for multiple distros without throwing away the
1470 results of a previous distro build every time.
1471 .IP \[bu] 2
1472 The preferred names for mkosi configuration files and directories are
1473 now \f[CR]mkosi.conf\f[R] and \f[CR]mkosi.conf.d/\f[R] respectively.
1474 The old names (\f[CR]mkosi.default\f[R] and \f[CR]mkosi.default.d\f[R])
1475 have been removed from the docs but are still supported for backwards
1476 compatibility.
1477 .IP \[bu] 2
1478 \f[CR]plain_squashfs\f[R] type images will now also be named with a
1479 \f[CR].raw\f[R] suffix.
1480 .IP \[bu] 2
1481 \f[CR]tar\f[R] type images will now respect the \f[CR]\-\-compress\f[R]
1482 option.
1483 .IP \[bu] 2
1484 Pacman\[cq]s \f[CR]SigLevel\f[R] option was changed to use the same
1485 default value as used on Arch which is
1486 \f[CR]SigLevel = Required DatabaseOptional\f[R].
1487 If this results in keyring errors, you need to update the keyring by
1488 running \f[CR]pacman\-key \-\-populate archlinux\f[R].
1489 .IP \[bu] 2
1490 Support for CentOS 7 was dropped.
1491 If you still need to support CentOS 7, we recommend using any mkosi
1492 version up to 13.
1493 .IP \[bu] 2
1494 Support for BIOS/grub was dropped.
1495 because EFI hardware is widely available and legacy BIOS systems do not
1496 support the feature set to fully verify a boot chain from firmware to
1497 userland and it has become bothersome to maintain for little use.
1498 .RS 2
1499 .PP
1500 To generate BIOS images you can use any version of mkosi up to mkosi 13
1501 or the new \f[CR]\-\-bios\-size\f[R] option.
1502 This can be used to add a BIOS boot partition of the specified size on
1503 which \f[CR]grub\f[R] (or any other bootloader) can be installed with
1504 the help of mkosi\[cq]s script support (depending on your needs most
1505 likely \f[CR]mkosi.postinst\f[R] or \f[CR]mkosi.finalize\f[R]).
1506 This method can also be used for other EFI bootloaders that mkosi
1507 intentionally does not support.
1508 .RE
1509 .IP \[bu] 2
1510 mkosi now unconditionally copies the kernel, initrd and kernel cmdline
1511 from the image that were previously only copied out for Qemu boot.
1512 .IP \[bu] 2
1513 mkosi now runs apt and dpkg on the host.
1514 As such, we now require apt and dpkg to be installed on the host along
1515 with debootstrap in order to be able to build debian/ubuntu images.
1516 .IP \[bu] 2
1517 Split dm\-verity artifacts default names have been changed to match what
1518 \f[CR]systemd\f[R] and other tools expect: \f[CR]image.root.raw\f[R],
1519 \f[CR]image.root.verity\f[R], \f[CR]image.root.roothash\f[R],
1520 \f[CR]image.root.roothash.p7s\f[R] (same for \f[CR]usr\f[R] variants).
1521 .IP \[bu] 2
1522 \f[CR]mkosi\f[R] will again default to the same OS release as the host
1523 system when the host system uses the same distribution as the image
1524 that\[cq]s being built.
1525 .IP \[bu] 2
1526 By default, \f[CR]mkosi\f[R] will now change the owner of newly created
1527 directories to \f[CR]SUDO_UID\f[R] or \f[CR]PKEXEC_UID\f[R] if defined,
1528 unless \f[CR]\-\-no\-chown\f[R] is used.
1529 .IP \[bu] 2
1530 If \f[CR]systemd\-nspawn\f[R] v252 or newer is used, bind\-mounted
1531 directories with \f[CR]systemd\-nspawn\f[R] will use the new
1532 \f[CR]rootidmap\f[R] option so files and directories created from within
1533 the container will be owned by the actual directory owner on the host.
1534 .SS v13
1535 .IP \[bu] 2
1536 The \f[CR]\-\-network\-veth\f[R] option has been renamed to
1537 \f[CR]\-\-netdev\f[R].
1538 The old name made sense with virtual ethernet devices, but when booting
1539 images with qemu a TUN/TAP device is used instead.
1540 .IP \[bu] 2
1541 The network config file installed by mkosi when the
1542 \f[CR]\-\-netdev\f[R] (previously \f[CR]\-\-network\-veth\f[R]) option
1543 is used (formerly
1544 \f[CR]/etc/systemd/network/80\-mkosi\-network\-veth.network\f[R] in the
1545 image) now only matches network interfaces using the
1546 \f[CR]virtio_net\f[R] driver.
1547 Please make sure you weren\[cq]t relying on this file to configure any
1548 network interfaces other than the tun/tap virtio\-net interface created
1549 by mkosi when booting the image in QEMU with the \f[CR]\-\-netdev\f[R]
1550 option.
1551 If you were relying on this config file when the host system uses the
1552 same distribution as the image that\[cq]s being built.
1553 Instead, when no release is specified, mkosi will now always default to
1554 the default version embedded in mkosi itself.
1555 .IP \[bu] 2
1556 \f[CR]mkosi\f[R] will now use the \f[CR]pacman\f[R] keyring from the
1557 host when building Arch images.
1558 This means that users will, on top of installing
1559 \f[CR]archlinux\-keyring\f[R], also have to run
1560 \f[CR]pacman\-key \-\-init\f[R] and
1561 \f[CR]pacman\-key \-\-populate archlinux\f[R] on the host system to be
1562 able to build Arch images.
1563 Also, unless the package manager is configured to do it automatically,
1564 the host keyring will have to be updated after
1565 \f[CR]archlinux\-keyring\f[R] updates by running
1566 \f[CR]pacman\-key \-\-populate archlinux\f[R] and
1567 \f[CR]pacman\-key \-\-updatedb\f[R].
1568 .IP \[bu] 2
1569 Direct qemu linux boot is now supported with
1570 \f[CR]BootProtocols=linux\f[R].
1571 When enabled, the kernel image, initrd, and cmdline will be extracted
1572 from the image and passed to \f[CR]qemu\f[R] by \f[CR]mkosi qemu\f[R] to
1573 directly boot into the kernel image without a bootloader.
1574 This can be used to boot for example s390x images in \f[CR]qemu\f[R].
1575 .IP \[bu] 2
1576 The initrd will now always be rebuilt after the extra trees and build
1577 artifacts have been installed into the image.
1578 .IP \[bu] 2
1579 The github action has been migrated to Ubuntu Jammy.
1580 To migrate any jobs using the action, add
1581 \f[CR]runs\-on: ubuntu\-22.04\f[R] to the job config.
1582 .IP \[bu] 2
1583 All images are now configured by default with the \f[CR]C.UTF\-8\f[R]
1584 locale.
1585 .IP \[bu] 2
1586 New \f[CR]\-\-repository\-directory\f[R] option can be used to configure
1587 a directory with extra repository files to be used by the package
1588 manager when building an image.
1589 Note that this option is currently only supported for \f[CR]pacman\f[R]
1590 and \f[CR]dnf\f[R]\-based distros.
1591 .IP \[bu] 2
1592 Option \f[CR]\-\-skeleton\-tree\f[R] is now supported on Debian\-based
1593 distros.
1594 .IP \[bu] 2
1595 Removed \f[CR]\-\-hostname\f[R] as its trivial to configure using
1596 systemd\-firstboot.
1597 .IP \[bu] 2
1598 Removed default locale configuration as its trivial to configure using
1599 systemd\-firstboot and systemd writes a default locale well.
1600 .SS v12
1601 .IP \[bu] 2
1602 Fix handling of baselayout in Gentoo installations.
1603 .SS v11
1604 .IP \[bu] 2
1605 Support for Rocky Linux, Alma Linux, and Gentoo has been added!
1606 .IP \[bu] 2
1607 A new \f[CR]ManifestFormat=\f[R] option can be used to generate
1608 \[lq]manifest\[rq] files that describe what packages were installed.
1609 With \f[CR]json\f[R], a JSON file that shows the names and versions of
1610 all installed packages will be created.
1611 With \f[CR]changelog\f[R], a longer human\-readable file that shows
1612 package descriptions and changelogs will be generated.
1613 This latter format should be considered experimental and likely to
1614 change in later versions.
1615 .IP \[bu] 2
1616 A new \f[CR]RemovePackages=\f[R] option can be used to uninstall
1617 packages after the build and finalize scripts have been done.
1618 This is useful for the case where packages are required by the build
1619 scripts, or pulled in as dependencies for scriptlets of other packages,
1620 but are not necessary in the final image.
1621 .IP \[bu] 2
1622 A new \f[CR]BaseImage=\f[R] option can be used to build \[lq]system
1623 extensions\[rq] a.k.a.
1624 \[lq]sysexts\[rq] \[em] partial images which are mounted on top of an
1625 existing system to provide additional files under \f[CR]/usr/\f[R].
1626 See the \c
1627 .UR https://www.freedesktop.org/software/systemd/man/systemd-sysext.html
1628 systemd\-sysext man page
1629 .UE \c
1630 \ for more information.
1631 .IP \[bu] 2
1632 A new \f[CR]CleanPackageMetadata=\f[R] option can be used to force or
1633 disable the removal of package manager files.
1634 When this option is not used, they are removed when the package manager
1635 is not installed in the final image.
1636 .IP \[bu] 2
1637 A new \f[CR]UseHostRepositories=\f[R] option instructs mkosi to use
1638 repository configuration from the host system, instead of the internal
1639 list.
1640 .IP \[bu] 2
1641 A new \f[CR]SshAgent=\f[R] option configures the path to the ssh agent.
1642 .IP \[bu] 2
1643 A new \f[CR]SshPort=\f[R] option overrides the port used for ssh.
1644 .IP \[bu] 2
1645 The \f[CR]Verity=\f[R] setting supports a new value \f[CR]signed\f[R].
1646 When set, verity data will be signed and the result inserted as an
1647 additional partition in the image.
1648 See https://systemd.io/DISCOVERABLE_PARTITIONS for details about signed
1649 disk images.
1650 This information is used by \f[CR]systemd\-nspawn\f[R],
1651 \f[CR]systemd\-dissect\f[R], \f[CR]systemd\-sysext\f[R],
1652 \f[CR]systemd\-portabled\f[R] and \f[CR]systemd\f[R]\[cq]s
1653 \f[CR]RootImage=\f[R] setting (among others) to cryptographically
1654 validate the image file systems before use.
1655 .IP \[bu] 2
1656 The \f[CR]\-\-build\-environment=\f[R] option was renamed to
1657 \f[CR]\-\-environment=\f[R] and extended to cover \f[I]all\f[R] invoked
1658 scripts, not just the \f[CR]mkosi.build\f[R].
1659 The old name is still understood.
1660 .IP \[bu] 2
1661 With \f[CR]\-\-with\-network=never\f[R], \f[CR]dnf\f[R] is called with
1662 \f[CR]\-\-cacheonly\f[R], so that the package lists are not refreshed.
1663 This gives a degree of reproducibility when doing repeated installs with
1664 the same package set (and also makes installs significantly faster).
1665 .IP \[bu] 2
1666 The \f[CR]\-\-debug=\f[R] option gained a new value \f[CR]disk\f[R] to
1667 show information about disk sized and partition allocations.
1668 .IP \[bu] 2
1669 Some sections and settings have been renamed for clarity: [Packages] is
1670 now [Content], \f[CR]Password=\f[R], \f[CR]PasswordIsHashed=\f[R], and
1671 \f[CR]Autologin=\f[R] are now in [Content].
1672 The old names are still supported, but not documented.
1673 .IP \[bu] 2
1674 When
1675 \f[CR]\-\-prepare\-script=\f[R]/\f[CR]\-\-build\-script=\f[R]/\f[CR]\-\-finalize\-script=\f[R]
1676 is used with an empty argument, the corresponding script will not be
1677 called.
1678 .IP \[bu] 2
1679 Python 3.7 is the minimal supported version.
1680 .IP \[bu] 2
1681 Note to packagers: the Python \f[CR]cryptography\f[R] module is needed
1682 for signing of verity data.
1683 .SS v10
1684 .IP \[bu] 2
1685 Minimum supported Python version is now 3.7.
1686 .IP \[bu] 2
1687 Automatic configuration of the network for Arch Linux was removed to
1688 bring different distros more in line with each other.
1689 To add it back, add a postinstall script to configure your network
1690 manager of choice.
1691 .IP \[bu] 2
1692 The \f[CR]\-\-default\f[R] option was changed to not affect the search
1693 location of \f[CR]mkosi.default.d/\f[R].
1694 mkosi now always searches for \f[CR]mkosi.default.d/\f[R] in the working
1695 directory.
1696 .IP \[bu] 2
1697 \f[CR]quiet\f[R] was dropped from the default kernel command line.
1698 .IP \[bu] 2
1699 \f[CR]\-\-source\-file\-transfer\f[R] and
1700 \f[CR]\-\-source\-file\-transfer\-final\f[R] now accept an empty value
1701 as the argument which can be used to override a previous setting.
1702 .IP \[bu] 2
1703 A new command \f[CR]mkosi serve\f[R] can be used to serve build
1704 artifacts using a small embedded HTTP server.
1705 This is useful for \f[CR]machinectl pull\-raw \&...\f[R] and
1706 \f[CR]machinectl pull\-tar \&...\f[R].
1707 .IP \[bu] 2
1708 A new command \f[CR]mkosi genkey\f[R] can be used to generate secure
1709 boot keys for use with mkosi\[cq]s \f[CR]\-\-secure\-boot\f[R] options.
1710 The number of days the keys should remain valid can be specified via
1711 \f[CR]\-\-secure\-boot\-valid\-days=\f[R] and their CN via
1712 \f[CR]\-\-secure\-boot\-common\-name=\f[R].
1713 .IP \[bu] 2
1714 When booting images with \f[CR]qemu\f[R], firmware that supports Secure
1715 Boot will be used if available.
1716 .IP \[bu] 2
1717 \f[CR]\-\-source\-resolve\-symlinks\f[R] and
1718 \f[CR]\-\-source\-resolve\-symlinks\-final\f[R] options are added to
1719 control how symlinks in the build sources are handled when
1720 \f[CR]\-\-source\-file\-transfer[\-final]=copy\-all\f[R] is used.
1721 .IP \[bu] 2
1722 \f[CR]\-\-build\-environment=\f[R] option was added to set variables for
1723 the build script.
1724 .IP \[bu] 2
1725 \f[CR]\-\-usr\-only\f[R] option was added to build images that comprise
1726 only the \f[CR]/usr/\f[R] directory, instead of the whole root file
1727 system.
1728 This is useful for stateless systems where \f[CR]/etc/\f[R] and
1729 \f[CR]/var/\f[R] are populated by
1730 \f[CR]systemd\-tmpfiles\f[R]/\f[CR]systemd\-sysusers\f[R] and related
1731 calls at boot, or systems that are originally shipped without a root
1732 file system, but where \f[CR]systemd\-repart\f[R] adds one on the first
1733 boot.
1734 .IP \[bu] 2
1735 Support for \[lq]image versions\[rq] has been added.
1736 The version number can be set with \f[CR]\-\-version\-number=\f[R].
1737 It is included in the default output filename and passed as
1738 \f[CR]$IMAGE_VERSION\f[R] to the build script.
1739 In addition, \f[CR]mkosi bump\f[R] can be used to increase the version
1740 number by one, and \f[CR]\-\-auto\-bump\f[R] can be used to increase it
1741 automatically after successful builds.
1742 .IP \[bu] 2
1743 Support for \[lq]image identifiers\[rq] has been added.
1744 The id can be set with \f[CR]\-\-image=id\f[R] and is passed to the
1745 build script as \f[CR]$IMAGE_ID\f[R].
1746 .IP \[bu] 2
1747 The list of packages to install can be configured with
1748 \f[CR]\-\-base\-packages=\f[R].
1749 With \f[CR]\-\-base\-packages=no\f[R], only packages specified with
1750 \f[CR]\-\-packages=\f[R] will be installed.
1751 With \f[CR]\-\-base\-packages=conditional\f[R], various packages will be
1752 installed \[lq]conditionally\[rq], i.e.\ only if some other package is
1753 otherwise pulled in.
1754 For example, \f[CR]systemd\-udev\f[R] may be installed only if
1755 \f[CR]systemd\f[R] is listed in \f[CR]\-\-packages=\f[R].
1756 .IP \[bu] 2
1757 CPIO output format has been added.
1758 This is useful for kernel initramfs images.
1759 .IP \[bu] 2
1760 Output compression can be configured with \f[CR]\-\-compress\-fs=\f[R]
1761 and \f[CR]\-\-compress\-output=\f[R], and support for \f[CR]zstd\f[R]
1762 has been added.
1763 .IP \[bu] 2
1764 \f[CR]\-\-ssh\-key=\f[R] option was added to control the ssh key used to
1765 connect to the image.
1766 .IP \[bu] 2
1767 \f[CR]\-\-remove\-files=\f[R] option was added to remove file from the
1768 generated images.
1769 .IP \[bu] 2
1770 Inline comments are now allowed in config files (anything from
1771 \f[CR]#\f[R] until the end of the line will be ignored).
1772 .IP \[bu] 2
1773 The development branch was renamed from \f[CR]master\f[R] to
1774 \f[CR]main\f[R].
1775 .SS v9
1776 .SS Highlighted Changes
1777 .IP \[bu] 2
1778 The mkosi Github action now defaults to the current release of mkosi
1779 instead of the tip of the master branch.
1780 .IP \[bu] 2
1781 Add a \f[CR]ssh\f[R] verb and accompanying \f[CR]\-\-ssh\f[R] option.
1782 The latter sets up SSH keys for direct SSH access into a booted image,
1783 whereas the former can be used to start an SSH connection to the image.
1784 .IP \[bu] 2
1785 Allow for distribution specific \f[CR]mkosi.*\f[R] files in
1786 subdirectories of \f[CR]mkosi.default.d/\f[R].
1787 These files are only processed if a subdirectory named after the target
1788 distribution of the image is found in \f[CR]mkosi.default.d/\f[R].
1789 .IP \[bu] 2
1790 The summary of used options for the image is now only printed when
1791 building the image for the first time or when the \f[CR]summary\f[R]
1792 verb is used.
1793 .IP \[bu] 2
1794 All of mkosi\[cq]s output, except for the build script, will now go to
1795 stderr.
1796 There was no clear policy on this before and this choice makes it easier
1797 to use images generated and booted via mkosi with language servers using
1798 stdin and stdout for communication.
1799 .IP \[bu] 2
1800 \f[CR]\-\-source\-file\-transfer\f[R] now defaults to
1801 \f[CR]copy\-git\-others\f[R] to also include untracked files.
1802 .IP \[bu] 2
1803 \c
1804 .UR https://github.com/psf/black
1805 black
1806 .UE \c
1807 \ is now used as a code style and conformance with it is checked in CI.
1808 .IP \[bu] 2
1809 Add a new \f[CR]\-\-ephemeral\f[R] option to boot into a temporary
1810 snapshot of the image that will be thrown away on shutdown.
1811 .IP \[bu] 2
1812 Add a new option \f[CR]\-\-network\-veth\f[R] to set up a virtual
1813 Ethernet link between the host and the image for usage with nspawn or
1814 QEMU
1815 .IP \[bu] 2
1816 Add a new \f[CR]\-\-autologin\f[R] option to automatically log into the
1817 root account upon boot of the image.
1818 This is useful when using mkosi for boot tests.
1819 .IP \[bu] 2
1820 Add a new \f[CR]\-\-hostonly\f[R] option to generate host specific
1821 initrds.
1822 This is useful when using mkosi for boot tests.
1823 .IP \[bu] 2
1824 Add a new \f[CR]\-\-install\-directory\f[R] option and special directory
1825 \f[CR]mkosi.installdir/\f[R] that will be used as \f[CR]$DESTDIR\f[R]
1826 for the build script, so that the contents of this directory can be
1827 shared between builds.
1828 .IP \[bu] 2
1829 Add a new \f[CR]\-\-include\-directory\f[R] option and special directory
1830 \f[CR]mkosi.includedir/\f[R] that will be mounted at
1831 \f[CR]/usr/include\f[R] during the build.
1832 This way headers files installed during the build can be made available
1833 to the host system, which is useful for usage with language servers.
1834 .IP \[bu] 2
1835 Add a new \f[CR]\-\-source\-file\-transfer\-final\f[R] option to
1836 complement \f[CR]\-\-source\-file\-transfer\f[R].
1837 It does the same \f[CR]\-\-source\-file\-transfer\f[R] does for the
1838 build image, but for the final one.
1839 .IP \[bu] 2
1840 Add a new \f[CR]\-\-tar\-strip\-selinux\-context\f[R] option to remove
1841 SELinux xattrs.
1842 This is useful when an image with a target distribution not using
1843 SELinux is generated on a host that is using it.
1844 .IP \[bu] 2
1845 Document the \f[CR]\-\-no\-chown\f[R] option.
1846 Using this option, artifacts generated by mkosi are not chowned to the
1847 user invoking mkosi when it is invoked via sudo.
1848 It has been with as for a while, but hasn\[cq]t been documented until
1849 now.
1850 .SS Fixed Issues
1851 .IP \[bu] 2
1852 \c
1853 .UR https://github.com/systemd/mkosi/issues/506
1854 #506
1855 .UE \c
1856 .IP \[bu] 2
1857 \c
1858 .UR https://github.com/systemd/mkosi/issues/559
1859 #559
1860 .UE \c
1861 .IP \[bu] 2
1862 \c
1863 .UR https://github.com/systemd/mkosi/issues/561
1864 #561
1865 .UE \c
1866 .IP \[bu] 2
1867 \c
1868 .UR https://github.com/systemd/mkosi/issues/562
1869 #562
1870 .UE \c
1871 .IP \[bu] 2
1872 \c
1873 .UR https://github.com/systemd/mkosi/issues/575
1874 #575
1875 .UE \c
1876 .IP \[bu] 2
1877 \c
1878 .UR https://github.com/systemd/mkosi/issues/580
1879 #580
1880 .UE \c
1881 .IP \[bu] 2
1882 \c
1883 .UR https://github.com/systemd/mkosi/issues/593
1884 #593
1885 .UE \c
1886 .SS Authors
1887 .IP \[bu] 2
1888 Daan De Meyer
1889 .IP \[bu] 2
1890 Joerg Behrmann
1891 .IP \[bu] 2
1892 Luca Boccassi
1893 .IP \[bu] 2
1894 Peter Hutterer
1895 .IP \[bu] 2
1896 ValdikSS