.\" Automatically generated by Pandoc 3.6
.\"
.TH "mkosi\-initrd" "1" "" ""
.SH NAME
mkosi\-initrd \[em] Build initrds or unified kernel images for the
current system using mkosi
.SH SYNOPSIS
\f[CR]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[CR]\-\-kernel\-version=\f[R], \f[CR]\-k\f[R]
Kernel version where to look for the kernel modules to include.
Defaults to the kernel version of the running system
(\f[CR]uname \-r\f[R]).
.TP
\f[CR]\-\-format=\f[R], \f[CR]\-t\f[R]
Output format.
One of \f[CR]cpio\f[R] (CPIO archive), \f[CR]uki\f[R] (a unified kernel
image with the image in the \f[CR].initrd\f[R] PE section) or
\f[CR]directory\f[R] (for generating an image directly in a local
directory).
Defaults to \f[CR]cpio\f[R].
.TP
\f[CR]\-\-output=\f[R], \f[CR]\-o\f[R]
Name to use for the generated output image file or directory.
Defaults to \f[CR]initrd\f[R].
.TP
\f[CR]\-\-output\-dir=\f[R], \f[CR]\-O\f[R]
Path to a directory where to place all generated artifacts.
Defaults to the current working directory.
.TP
\f[CR]\-\-generic\f[R], \f[CR]\-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\[cq]s tied to the kernel version of the running system or set with
\f[CR]\-\-kernel\-version=\f[R].
.TP
\f[CR]\-\-profile=\f[R]
Set the profiles to enable for the initrd.
By default, all profiles are disabled.
.RS
.PP
The \f[CR]lvm\f[R] profile enables support for LVM.
The \f[CR]network\f[R] profile enables support for network via
\f[B]systemd\-networkd\f[R].
The \f[CR]nfs\f[R] profile enables support for NFS.
It requires networking in the initrd, using the \f[CR]network\f[R]
profile, or some other custom method.
The \f[CR]pkcs11\f[R] profile enables support for PKCS#11.
The \f[CR]plymouth\f[R] profile provides a graphical interface at boot
(animation and password prompt).
The \f[CR]raid\f[R] profile enables support for RAID arrays.
.RE
.TP
\f[CR]\-\-debug\f[R]
Enable additional debugging output.
.TP
\f[CR]\-\-debug\-shell\f[R]
Spawn debug shell in sandbox if a sandboxed command fails.
.TP
\f[CR]\-\-debug\-sandbox\f[R]
Run \f[B]mkosi\-sandbox\f[R] with \f[B]strace\f[R].
.TP
\f[CR]\-\-version\f[R]
Show package version.
.TP
\f[CR]\-\-help\f[R], \f[CR]\-h\f[R]
Show brief usage information.
.SH SEE ALSO
\f[CR]mkosi(1)\f[R]