.\" Automatically generated by Pandoc 3.10.2
.\"
.TH "mkosi\-initrd" "1" "" ""
.SH NAME
mkosi\-initrd \(em Build initrds or unified kernel images for the
current system using mkosi
.SH SYNOPSIS
\f[B]mkosi\-initrd [options\&...]\f[R]
.SH DESCRIPTION
\f[B]mkosi\-initrd\f[R] is wrapper on top of \f[B]mkosi\f[R] to simplify
the generation of initrds and Unified Kernel Images for the current
running system.
.SH OPTIONS
.TP
\f[B]\-\-kernel\-version=\f[R], \f[B]\-k\f[R]
Kernel version where to look for the kernel modules to include.
Defaults to the kernel version of the running system (\f[B]uname
\-r\f[R]).
.TP
\f[B]\-\-format=\f[R], \f[B]\-t\f[R]
Output format.
One of \f[B]cpio\f[R] (CPIO archive), \f[B]uki\f[R] (a unified kernel
image with the image in the \f[B].initrd\f[R] PE section) or
\f[B]directory\f[R] (for generating an image directly in a local
directory).
Defaults to \f[B]cpio\f[R].
.TP
\f[B]\-\-output=\f[R], \f[B]\-o\f[R]
Name to use for the generated output image file or directory.
Defaults to \f[B]initrd\f[R].
.TP
\f[B]\-\-output\-dir=\f[R], \f[B]\-O\f[R]
Path to a directory where to place all generated artifacts.
Defaults to the current working directory.
.TP
\f[B]\-\-generic\f[R], \f[B]\-g\f[R]
Build a generic initrd without host\-specific kernel modules, which
should allow the local system to boot on different hardware, although
it\(cqs tied to the kernel version of the running system or set with
\f[B]\-\-kernel\-version=\f[R].
.TP
\f[B]\-\-profile=\f[R]
Set the profiles to enable for the initrd.
By default, all profiles are disabled.
.RS
The \f[B]lvm\f[R] profile enables support for LVM.
The \f[B]network\f[R] profile enables support for network via
\f[B]systemd\-networkd\f[R].
The \f[B]nfs\f[R] profile enables support for NFS.
It requires networking in the initrd, using the \f[B]network\f[R]
profile, or some other custom method.
The \f[B]pkcs11\f[R] profile enables support for PKCS#11.
The \f[B]plymouth\f[R] profile provides a graphical interface at boot
(animation and password prompt).
The \f[B]raid\f[R] profile enables support for RAID arrays.
.RE
.TP
\f[B]\-\-debug\f[R]
Enable additional debugging output.
.TP
\f[B]\-\-debug\-shell\f[R]
Spawn debug shell in sandbox if a sandboxed command fails.
.TP
\f[B]\-\-debug\-sandbox\f[R]
Run \f[B]mkosi\-sandbox\f[R] with \f[B]strace\f[R].
.TP
\f[B]\-\-show\-documentation\f[R], \f[B]\-D\f[R]
Show the man page for mkosi\-initrd.
.TP
\f[B]\-\-show\-summary\f[R], \f[B]\-S\f[R]
Show the summary of configuration.
.TP
\f[B]\-\-version\f[R]
Show package version.
.TP
\f[B]\-\-help\f[R], \f[B]\-h\f[R]
Show brief usage information.
.SH CONFIGURATION
Configuration for \f[B]mkosi\-initrd\f[R] is read from
\f[B]/usr/lib\f[R], \f[B]/usr/local/lib\f[R], \f[B]/run\f[R],
\f[B]/etc\f[R], in increasing order of priority.
Under any of those directories, \f[B]mkosi.conf.d/\f[R] can be used for
config files, \f[B]mkosi.extra/\f[R] can be used for extra files to
include in the initrd, and so on.
See the \f[B]Configuration Settings\f[R] and \f[B]FILES\f[R] sections in
\f[B]mkosi\f[R](1) for full details.
.PP
For configuration files, use drop\-ins,
e.g.\ \f[B]/etc/mkosi\-initrd/mkosi.conf.d/local.conf\f[R].
.SH SEE ALSO
\f[B]mkosi\f[R](1)