dracut.conf is loaded during the initialisation phase of dracut.
Command line parameter will override any values set here.
*.conf files are read from /usr/lib/dracut/dracut.conf.d and
/etc/dracut.conf.d. Files with the same name in
/etc/dracut.conf.d will replace files in
/usr/lib/dracut/dracut.conf.d. The files are then read in
alphanumerical order and will override parameters set in
/etc/dracut.conf. Each line specifies an attribute and a value. A
# indicates the beginning of a comment; following characters, up
to the end of the line are not interpreted.
dracut command line options will override any values set here.
Configuration files must have the extension .conf; other
extensions are ignored.
add_dracutmodules+=" <dracut modules> "
Add a space-separated list of dracut modules to call when
building the initramfs. Modules are located in
/usr/lib/dracut/modules.d.
dracutmodules+=" <dracut modules> "
Specify a space-separated list of dracut modules to call when
building the initramfs. Modules are located in
/usr/lib/dracut/modules.d. This option forces dracut to only
include the specified dracut modules. In most cases the
"add_dracutmodules" option is what you want to use.
omit_dracutmodules+=" <dracut modules> "
Omit a space-separated list of dracut modules to call when
building the initramfs. Modules are located in
/usr/lib/dracut/modules.d.
drivers+=" <kernel modules> "
Specify a space-separated list of kernel modules to
exclusively include in the initramfs. The kernel modules have
to be specified without the ".ko" suffix.
add_drivers+=" <kernel modules> "
Specify a space-separated list of kernel modules to add to
the initramfs. The kernel modules have to be specified
without the ".ko" suffix.
force_drivers+=" <list of kernel modules> "
See add_drivers above. But in this case it is ensured that
the drivers are tried to be loaded early via modprobe.
omit_drivers+=" <kernel modules> "
Specify a space-separated list of kernel modules not to add
to the initramfs. The kernel modules have to be specified
without the ".ko" suffix.
filesystems+=" <filesystem names> "
Specify a space-separated list of kernel filesystem modules
to exclusively include in the generic initramfs.
drivers_dir="<kernel modules directory>"
Specify the directory, where to look for kernel modules
fw_dir+=" :<dir>[:<dir> ...] "
Specify additional directories, where to look for firmwares,
separated by :
install_items+=" <file>[ <file> ...] "
Specify additional files to include in the initramfs,
separated by spaces.
install_optional_items+=" <file>[ <file> ...] "
Specify additional files to include in the initramfs,
separated by spaces, if they exist.
compress="{cat|bzip2|lzma|xz|gzip|lzo|lz4|zstd|<compressor [args
...]>}"
Compress the generated initramfs using the passed compression
program. If you pass it just the name of a compression
program, it will call that program with known-working
arguments. If you pass arguments, it will be called with
exactly those arguments. Depending on what you pass, this may
result in an initramfs that the kernel cannot decompress. To
disable compression, use "cat".
do_strip="{yes|no}"
Strip binaries in the initramfs (default=yes)
hostonly="{yes|no}"
Host-Only mode: Install only what is needed for booting the
local host instead of a generic host and generate
host-specific configuration.
hostonly_cmdline="{yes|no}"
If set to "yes", store the kernel command line arguments
needed in the initramfs
persistent_policy="<policy>"
Use <policy> to address disks and partitions. <policy> can
be any directory name found in /dev/disk. E.g. "by-uuid",
"by-label"
tmpdir="<temporary directory>"
Specify temporary directory to use.
Warning
If chrooted to another root other than the real root device,
use --fstab and provide a valid /etc/fstab.
use_fstab="{yes|no}"
Use /etc/fstab instead of /proc/self/mountinfo.
add_fstab+=" <filename> "
Add entries of <filename> to the initramfs /etc/fstab.
add_device+=" <device> "
Bring up <device> in initramfs, <device> should be the device
name. This can be useful in hostonly mode for resume support
when your swap is on LVM an encrypted partition.
mdadmconf="{yes|no}"
Include local /etc/mdadm.conf (default=yes)
lvmconf="{yes|no}"
Include local /etc/lvm/lvm.conf (default=yes)
fscks=" <fsck tools> "
Add a space-separated list of fsck tools. If nothing is
specified, the default is: "umount mount /sbin/fsck* xfs_db
xfs_check xfs_repair e2fsck jfs_fsck reiserfsck btrfsck". The
installation is opportunistic (non-existing tools are
ignored).
nofscks="{yes|no}"
If specified, inhibit installation of any fsck tools.
ro_mnt="{yes|no}"
Mount / and /usr read-only by default.
kernel_cmdline="parameters"
Specify default kernel command line parameters
kernel_only="{yes|no}"
Only install kernel drivers and firmware files. (default=no)
no_kernel="{yes|no}"
Do not install kernel drivers and firmware files (default=no)
acpi_override="{yes|no}"
[WARNING] ONLY USE THIS IF YOU KNOW WHAT YOU ARE DOING!
Override BIOS provided ACPI tables. For further documentation
read Documentation/acpi/initrd_table_override.txt in the
kernel sources. Search for ACPI table files (must have .aml
suffix) in acpi_table_dir= directory (see below) and add them
to a separate uncompressed cpio archive. This cpio archive
gets glued (concatenated, uncompressed one must be the first
one) to the compressed cpio archive. The first, uncompressed
cpio archive is for data which the kernel must be able to
access very early (and cannot make use of uncompress
algorithms yet) like microcode or ACPI tables (default=no).
acpi_table_dir="<dir>"
Directory to search for ACPI tables if acpi_override= is set
to yes.
early_microcode="{yes|no}"
Combine early microcode with ramdisk (default=yes)
stdloglvl="{0-6}"
Set logging to standard error level.
sysloglvl="{0-6}"
Set logging to syslog level.
fileloglvl="{0-6}"
Set logging to file level.
logfile="<file>"
Path to log file.
show_modules="{yes|no}"
Print the name of the included modules to standard output
during build.
i18n_vars="<variable mapping>"
Distribution specific variable mapping. See
dracut/modules.d/10i18n/README for a detailed description.
i18n_default_font="<fontname>"
The font <fontname> to install, if not specified otherwise.
Default is "eurlatgr".
i18n_install_all="{yes|no}"
Install everything regardless of generic or hostonly mode.
reproducible="{yes|no}"
Create reproducible images.
loginstall="<DIR>"
Log all files installed from the host to <DIR>.
uefi_stub="<FILE>"
Specifies the UEFI stub loader, which will load the attached
kernel, initramfs and kernel command line and boots the
kernel. The default is
/lib/systemd/boot/efi/linux<EFI-MACHINE-TYPE-NAME>.efi.stub
or /usr/lib/gummiboot/linux<EFI-MACHINE-TYPE-NAME>.efi.stub
uefi_splash_image="<FILE>"
Specifies the UEFI stub loader's splash image. Requires
bitmap (.bmp) image format.
uefi_secureboot_cert="<FILE>", uefi_secureboot_key="<FILE>"
Specifies a certificate and corresponding key, which are used
to sign the created UEFI executable. Requires both
certificate and key need to be specified and sbsign to be
installed.
kernel_image="<FILE>"
Specifies the kernel image, which to include in the UEFI
executable. The default is
/lib/modules/<KERNEL-VERSION>/vmlinuz or
/boot/vmlinuz-<KERNEL-VERSION>
