DESCRIPTION¶
dracut.conf is loaded during the initialisation phase of
dracut. Command line parameter will overwrite 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 overwrite 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 overwrite any values set
here.
Configuration files must have the extension .conf; other
extensions are ignored.
Warning
Space-separated lists have to have a leading and trailing
space!
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.
omit_dracutmodules+=" <dracut
modules> "
Omit a space-separated list of dracut modules.
add_dracutmodules+=" <dracut
modules> "
Add a space-separated list of dracut modules.
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.
do_strip="{yes|no}"
Strip binaries in the initramfs (default=yes)
do_prelink="{yes|no}"
Prelink 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, store the kernel command line arguments needed in
the initramfs
i18n_install_all="{yes|no}"
If set to yes, install all available fonts and keyboard
files.
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 alogrithms 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=no)
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 "LatArCyrHeb-16".
i18n_install_all="{yes|no}"
Install everything regardless of generic or hostonly
mode.