dracut.conf (5)


NAME

dracut.conf - configuration file(s) for dracut

SYNOPSIS

/etc/dracut.conf /etc/dracut.conf.d/.conf /usr/lib/dracut/dracut.conf.d/.conf

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.

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.

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.

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.

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 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)

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.

FILES

/etc/dracut.conf

Old configuration file. You better use your own file in /etc/dracut.conf.d/.

/etc/dracut.conf.d/

Any /etc/dracut.conf.d/*.conf file can overwrite the values in /etc/dracut.conf. The configuration files are read in alphanumerical order.

AUTHOR

Harald Hoyer

SEE ALSO

dracut(8) dracut.cmdline(7)