dracut.conf(5)

1DRACUT.CONF(5)                      dracut                      DRACUT.CONF(5)
2
3
4

NAME

6       dracut.conf - configuration file(s) for dracut
7

SYNOPSIS

9       /etc/dracut.conf /etc/dracut.conf.d/*.conf
10       /usr/lib/dracut/dracut.conf.d/*.conf
11

DESCRIPTION

13       dracut.conf is loaded during the initialisation phase of dracut.
14       Command line parameter will override any values set here.
15
16       *.conf files are read from /usr/lib/dracut/dracut.conf.d and
17       /etc/dracut.conf.d. Files with the same name in /etc/dracut.conf.d will
18       replace files in /usr/lib/dracut/dracut.conf.d. The files are then read
19       in alphanumerical order and will override parameters set in
20       /etc/dracut.conf. Each line specifies an attribute and a value. A #
21       indicates the beginning of a comment; following characters, up to the
22       end of the line are not interpreted.
23
24       dracut command line options will override any values set here.
25
26       Configuration files must have the extension .conf; other extensions are
27       ignored.
28
29       add_dracutmodules+=" <dracut modules> "
30           Add a space-separated list of dracut modules to call when building
31           the initramfs. Modules are located in /usr/lib/dracut/modules.d.
32
33       dracutmodules+=" <dracut modules> "
34           Specify a space-separated list of dracut modules to call when
35           building the initramfs. Modules are located in
36           /usr/lib/dracut/modules.d. This option forces dracut to only
37           include the specified dracut modules. In most cases the
38           "add_dracutmodules" option is what you want to use.
39
40       omit_dracutmodules+=" <dracut modules> "
41           Omit a space-separated list of dracut modules to call when building
42           the initramfs. Modules are located in /usr/lib/dracut/modules.d.
43
44       drivers+=" <kernel modules> "
45           Specify a space-separated list of kernel modules to exclusively
46           include in the initramfs. The kernel modules have to be specified
47           without the ".ko" suffix.
48
49       add_drivers+=" <kernel modules> "
50           Specify a space-separated list of kernel modules to add to the
51           initramfs. The kernel modules have to be specified without the
52           ".ko" suffix.
53
54       force_drivers+=" <list of kernel modules> "
55           See add_drivers above. But in this case it is ensured that the
56           drivers are tried to be loaded early via modprobe.
57
58       omit_drivers+=" <kernel modules> "
59           Specify a space-separated list of kernel modules not to add to the
60           initramfs. The kernel modules have to be specified without the
61           ".ko" suffix.
62
63       filesystems+=" <filesystem names> "
64           Specify a space-separated list of kernel filesystem modules to
65           exclusively include in the generic initramfs.
66
67       drivers_dir="<kernel modules directory>"
68           Specify the directory, where to look for kernel modules
69
70       fw_dir+=" :<dir>[:<dir> ...] "
71           Specify additional directories, where to look for firmwares,
72           separated by :
73
74       install_items+=" <file>[ <file> ...] "
75           Specify additional files to include in the initramfs, separated by
76           spaces.
77
78       install_optional_items+=" <file>[ <file> ...] "
79           Specify additional files to include in the initramfs, separated by
80           spaces, if they exist.
81
82       compress="{cat|bzip2|lzma|xz|gzip|lzo|lz4|zstd|<compressor [args
83       ...]>}"
84           Compress the generated initramfs using the passed compression
85           program. If you pass it just the name of a compression program, it
86           will call that program with known-working arguments. If you pass
87           arguments, it will be called with exactly those arguments.
88           Depending on what you pass, this may result in an initramfs that
89           the kernel cannot decompress. To disable compression, use "cat".
90
91       do_strip="{yes|no}"
92           Strip binaries in the initramfs (default=yes)
93
94       hostonly="{yes|no}"
95           Host-Only mode: Install only what is needed for booting the local
96           host instead of a generic host and generate host-specific
97           configuration.
98
99       hostonly_cmdline="{yes|no}"
100           If set to "yes", store the kernel command line arguments needed in
101           the initramfs
102
103       persistent_policy="<policy>"
104           Use <policy> to address disks and partitions.  <policy> can be any
105           directory name found in /dev/disk. E.g. "by-uuid", "by-label"
106
107       tmpdir="<temporary directory>"
108           Specify temporary directory to use.
109
110           Warning
111           If chrooted to another root other than the real root device, use
112           --fstab and provide a valid /etc/fstab.
113
114       use_fstab="{yes|no}"
115           Use /etc/fstab instead of /proc/self/mountinfo.
116
117       add_fstab+=" <filename> "
118           Add entries of <filename> to the initramfs /etc/fstab.
119
120       add_device+=" <device> "
121           Bring up <device> in initramfs, <device> should be the device name.
122           This can be useful in hostonly mode for resume support when your
123           swap is on LVM an encrypted partition.
124
125       mdadmconf="{yes|no}"
126           Include local /etc/mdadm.conf (default=yes)
127
128       lvmconf="{yes|no}"
129           Include local /etc/lvm/lvm.conf (default=yes)
130
131       fscks=" <fsck tools> "
132           Add a space-separated list of fsck tools. If nothing is specified,
133           the default is: "umount mount /sbin/fsck* xfs_db xfs_check
134           xfs_repair e2fsck jfs_fsck reiserfsck btrfsck". The installation is
135           opportunistic (non-existing tools are ignored).
136
137       nofscks="{yes|no}"
138           If specified, inhibit installation of any fsck tools.
139
140       ro_mnt="{yes|no}"
141           Mount / and /usr read-only by default.
142
143       kernel_cmdline="parameters"
144           Specify default kernel command line parameters
145
146       kernel_only="{yes|no}"
147           Only install kernel drivers and firmware files. (default=no)
148
149       no_kernel="{yes|no}"
150           Do not install kernel drivers and firmware files (default=no)
151
152       acpi_override="{yes|no}"
153           [WARNING] ONLY USE THIS IF YOU KNOW WHAT YOU ARE DOING!
154
155           Override BIOS provided ACPI tables. For further documentation read
156           Documentation/acpi/initrd_table_override.txt in the kernel sources.
157           Search for ACPI table files (must have .aml suffix) in
158           acpi_table_dir= directory (see below) and add them to a separate
159           uncompressed cpio archive. This cpio archive gets glued
160           (concatenated, uncompressed one must be the first one) to the
161           compressed cpio archive. The first, uncompressed cpio archive is
162           for data which the kernel must be able to access very early (and
163           cannot make use of uncompress algorithms yet) like microcode or
164           ACPI tables (default=no).
165
166       acpi_table_dir="<dir>"
167           Directory to search for ACPI tables if acpi_override= is set to
168           yes.
169
170       early_microcode="{yes|no}"
171           Combine early microcode with ramdisk (default=yes)
172
173       stdloglvl="{0-6}"
174           Set logging to standard error level.
175
176       sysloglvl="{0-6}"
177           Set logging to syslog level.
178
179       fileloglvl="{0-6}"
180           Set logging to file level.
181
182       logfile="<file>"
183           Path to log file.
184
185       show_modules="{yes|no}"
186           Print the name of the included modules to standard output during
187           build.
188
189       i18n_vars="<variable mapping>"
190           Distribution specific variable mapping. See
191           dracut/modules.d/10i18n/README for a detailed description.
192
193       i18n_default_font="<fontname>"
194           The font <fontname> to install, if not specified otherwise. Default
195           is "eurlatgr".
196
197       i18n_install_all="{yes|no}"
198           Install everything regardless of generic or hostonly mode.
199
200       reproducible="{yes|no}"
201           Create reproducible images.
202
203       loginstall="<DIR>"
204           Log all files installed from the host to <DIR>.
205
206       uefi_stub="<FILE>"
207           Specifies the UEFI stub loader, which will load the attached
208           kernel, initramfs and kernel command line and boots the kernel. The
209           default is
210           /lib/systemd/boot/efi/linux<EFI-MACHINE-TYPE-NAME>.efi.stub
211
212       uefi_splash_image="<FILE>"
213           Specifies the UEFI stub loader’s splash image. Requires bitmap
214           (.bmp) image format.
215
216       uefi_secureboot_cert="<FILE>", uefi_secureboot_key="<FILE>"
217           Specifies a certificate and corresponding key, which are used to
218           sign the created UEFI executable. Requires both certificate and key
219           need to be specified and sbsign to be installed.
220
221       kernel_image="<FILE>"
222           Specifies the kernel image, which to include in the UEFI
223           executable. The default is /lib/modules/<KERNEL-VERSION>/vmlinuz or
224           /boot/vmlinuz-<KERNEL-VERSION>
225

FILES

227       /etc/dracut.conf
228           Old configuration file. You better use your own file in
229           /etc/dracut.conf.d/.
230
231       /etc/dracut.conf.d/
232           Any /etc/dracut.conf.d/*.conf file can override the values in
233           /etc/dracut.conf. The configuration files are read in
234           alphanumerical order.
235

AUTHOR

237       Harald Hoyer
238

NAME

SYNOPSIS

DESCRIPTION

FILES

AUTHOR

SEE ALSO