table of contents
- bookworm 059-4
- bookworm-backports 106-5~bpo12+1
- testing 106-5
- unstable 106-5
DRACUT.CONF(5) | dracut | 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 initialization phase of dracut.
*.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; the 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.
CONFIGURATION OPTIONS¶
add_dracutmodules+=" <dracut modules> "
force_add_dracutmodules+=" <dracut modules> "
omit_dracutmodules+=" <dracut modules> "
Warning
Avoid manually omitting dracut modules, as you may inadvertently remove essential ones that dracut can’t detect or warn you about. Using this option is not recommended and is at your own risk.
dracutmodules+=" <dracut modules> "
add_drivers+=" <kernel modules> "
force_drivers+=" <list of kernel modules> "
omit_drivers+=" <kernel modules> "
drivers+=" <kernel modules> "
filesystems+=" <filesystem names> "
drivers_dir="<kernel modules directory>"
fw_dir+=" :<dir>[:<dir> ...] "
libdirs+=" <dir>[ <dir> ...] "
install_items+=" <file>[ <file> ...] "
install_optional_items+=" <file>[ <file> ...] "
compress="{cat|bzip2|lzma|xz|gzip|lzop|lz4|zstd|<compressor [args ...]>}"
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".
squash_compress="{<compressor [args ...]>}"
If squash module is not called when building the initramfs, this option will not take effect.
do_strip="{yes|no}"
aggressive_strip="{yes|no}"
do_hardlink="{yes|no}"
prefix=" <directory> "
hostonly="{yes|no}"
hostonly_mode="{sloppy|strict}"
In "sloppy" host-only mode, extra drivers and modules will be installed, so minor hardware change won’t make the image unbootable (e.g. changed keyboard), and the image is still portable among similar hosts.
With "strict" mode enabled, anything not necessary for booting the local host in its current state will not be included, and modules may make additional efforts to save more space. Minor changes in hardware or environment can make the image unbootable.
hostonly_cmdline="{yes|no}"
hostonly_nics+=" [<nic>[ <nic> ...]] "
persistent_policy="<policy>"
tmpdir="<temporary directory>"
Warning
If chrooted to another root other than the real root device, use --fstab and provide a valid /etc/fstab.
use_fstab="{yes|no}"
add_fstab+=" <filename> "
add_device+=" <device> "
mdadmconf="{yes|no}"
lvmconf="{yes|no}"
fscks=" <fsck tools> "
If nothing is specified, the default is umount mount /sbin/fsck* xfs_db xfs_check xfs_repair e2fsck jfs_fsck btrfsck.
The installation is opportunistic (non-existing tools are ignored).
nofscks="{yes|no}"
ro_mnt="{yes|no}"
kernel_cmdline="parameters"
kernel_only="{yes|no}"
no_kernel="{yes|no}"
acpi_override="{yes|no}"
Caution
Only use this if you know what you are doing!
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>"
early_microcode="{yes|no}"
stdloglvl="{0-6}"
Table 1. Logging Levels
0 | suppress any messages |
1 | only fatal errors |
2 | all errors |
3 | warnings |
4 | info |
5 | debug info (here starts lots of output) |
6 | trace info (and even more) |
sysloglvl="{0-6}"
fileloglvl="{0-6}"
logfile="<file>"
sshkey="<file>"
show_modules="{yes|no}"
i18n_vars="<variable mapping>"
i18n_default_font="<fontname>"
i18n_install_all="{yes|no}"
reproducible="{yes|no}"
noimageifnotneeded="{yes|no}"
loginstall="<directory>"
uefi="{yes|no}"
The default output filename is <EFI>/EFI/Linux/linux-$kernel$-<MACHINE_ID>-<BUILD_ID>.efi. <EFI> might be /efi, /boot or /boot/efi depending on where the ESP partition is mounted. The <BUILD_ID> is taken from BUILD_ID in /usr/lib/os-release or if it exists /etc/os-release and is left out, if BUILD_ID is non-existent or empty.
machine_id="{yes|no}"
uefi_stub="<file>"
uefi_splash_image="<file>"
uefi_secureboot_cert="<file>", uefi_secureboot_key="<file>"
uefi_secureboot_engine="parameter"
kernel_image="<file>"
sbat="parameters"
enhanced_cpio="{yes|no}"
When specified, initramfs archives are also padded to ensure optimal data alignment for extent sharing. To retain reflink data deduplication benefits, this should be used alongside the compress="cat" and do_strip="no" parameters, with initramfs source files, tmpdir staging area and destination all on the same copy-on-write capable file-system.
parallel="{yes|no}"
initrdname="<filepattern>"
The initrdname configuration option is required to match the initr*${kernel}* file pattern and only one file with this pattern should exists in the directory where initramfs is loaded from.
Defaults to initrd.img-${kernel}.
FILES¶
/etc/dracut.conf
/etc/dracut.conf.d/
AUTHOR¶
Harald Hoyer
SEE ALSO¶
NOTES¶
- 1.
- Documentation/acpi/initrd_table_override.txt
02/22/2025 | dracut 106-5 |