1DRACUT.CONF(5) dracut DRACUT.CONF(5)
2
6 dracut.conf - configuration file(s) for dracut
7
9 /etc/dracut.conf /etc/dracut.conf.d/*.conf
10 /usr/lib/dracut/dracut.conf.d/*.conf
11
13 dracut.conf is loaded during the initialisation phase of dracut.
14 Command line parameter will override any values set here.
15 *.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 dracut command line options will override any values set here.
25 Configuration files must have the extension .conf; other extensions are
27 ignored.
28 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 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 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 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 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 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 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 filesystems+=" <filesystem names> "
64 Specify a space-separated list of kernel filesystem modules to
65 exclusively include in the generic initramfs.
66 drivers_dir="<kernel modules directory>"
68 Specify the directory, where to look for kernel modules
69 fw_dir+=" :<dir>[:<dir> ...] "
71 Specify additional directories, where to look for firmwares,
72 separated by :
73 install_items+=" <file>[ <file> ...] "
75 Specify additional files to include in the initramfs, separated by
76 spaces.
77 install_optional_items+=" <file>[ <file> ...] "
79 Specify additional files to include in the initramfs, separated by
80 spaces, if they exist.
81 compress="{bzip2|lzma|xz|gzip|lzo|lz4|zstd|<compressor [args ...]>}"
83 Compress the generated initramfs using the passed compression
84 program. If you pass it just the name of a compression program, it
85 will call that program with known-working arguments. If you pass
86 arguments, it will be called with exactly those arguments.
87 Depending on what you pass, this may result in an initramfs that
88 the kernel cannot decompress.
89 do_strip="{yes|no}"
91 Strip binaries in the initramfs (default=yes)
92 hostonly="{yes|no}"
94 Host-Only mode: Install only what is needed for booting the local
95 host instead of a generic host and generate host-specific
96 configuration.
97 hostonly_cmdline="{yes|no}"
99 If set to "yes", store the kernel command line arguments needed in
100 the initramfs
101 persistent_policy="<policy>"
103 Use <policy> to address disks and partitions. <policy> can be any
104 directory name found in /dev/disk. E.g. "by-uuid", "by-label"
105 tmpdir="<temporary directory>"
107 Specify temporary directory to use.
108 Warning
110 If chrooted to another root other than the real root device, use
111 --fstab and provide a valid /etc/fstab.
112 use_fstab="{yes|no}"
114 Use /etc/fstab instead of /proc/self/mountinfo.
115 add_fstab+=" <filename> "
117 Add entries of <filename> to the initramfs /etc/fstab.
118 add_device+=" <device> "
120 Bring up <device> in initramfs, <device> should be the device name.
121 This can be useful in hostonly mode for resume support when your
122 swap is on LVM an encrypted partition.
123 mdadmconf="{yes|no}"
125 Include local /etc/mdadm.conf (default=yes)
126 lvmconf="{yes|no}"
128 Include local /etc/lvm/lvm.conf (default=yes)
129 fscks=" <fsck tools> "
131 Add a space-separated list of fsck tools. If nothing is specified,
132 the default is: "umount mount /sbin/fsck* xfs_db xfs_check
133 xfs_repair e2fsck jfs_fsck reiserfsck btrfsck". The installation is
134 opportunistic (non-existing tools are ignored).
135 nofscks="{yes|no}"
137 If specified, inhibit installation of any fsck tools.
138 ro_mnt="{yes|no}"
140 Mount / and /usr read-only by default.
141 kernel_cmdline="parameters"
143 Specify default kernel command line parameters
144 kernel_only="{yes|no}"
146 Only install kernel drivers and firmware files. (default=no)
147 no_kernel="{yes|no}"
149 Do not install kernel drivers and firmware files (default=no)
150 acpi_override="{yes|no}"
152 [WARNING] ONLY USE THIS IF YOU KNOW WHAT YOU ARE DOING!
153 Override BIOS provided ACPI tables. For further documentation read
155 Documentation/acpi/initrd_table_override.txt in the kernel sources.
156 Search for ACPI table files (must have .aml suffix) in
157 acpi_table_dir= directory (see below) and add them to a separate
158 uncompressed cpio archive. This cpio archive gets glued
159 (concatenated, uncompressed one must be the first one) to the
160 compressed cpio archive. The first, uncompressed cpio archive is
161 for data which the kernel must be able to access very early (and
162 cannot make use of uncompress alogrithms yet) like microcode or
163 ACPI tables (default=no).
164 acpi_table_dir="<dir>"
166 Directory to search for ACPI tables if acpi_override= is set to
167 yes.
168 early_microcode="{yes|no}"
170 Combine early microcode with ramdisk (default=yes)
171 stdloglvl="{0-6}"
173 Set logging to standard error level.
174 sysloglvl="{0-6}"
176 Set logging to syslog level.
177 fileloglvl="{0-6}"
179 Set logging to file level.
180 logfile="<file>"
182 Path to log file.
183 show_modules="{yes|no}"
185 Print the name of the included modules to standard output during
186 build.
187 i18n_vars="<variable mapping>"
189 Distribution specific variable mapping. See
190 dracut/modules.d/10i18n/README for a detailed description.
191 i18n_default_font="<fontname>"
193 The font <fontname> to install, if not specified otherwise. Default
194 is "LatArCyrHeb-16".
195 i18n_install_all="{yes|no}"
197 Install everything regardless of generic or hostonly mode.
198 reproducible="{yes|no}"
200 Create reproducible images.
201 loginstall="<DIR>"
203 Log all files installed from the host to <DIR>.
204 uefi_stub="<FILE>"
206 Specifies the UEFI stub loader, which will load the attached
207 kernel, initramfs and kernel command line and boots the kernel. The
208 default is
209 /lib/systemd/boot/efi/linux<EFI-MACHINE-TYPE-NAME>.efi.stub or
210 /usr/lib/gummiboot/linux<EFI-MACHINE-TYPE-NAME>.efi.stub
211 kernel_image="<FILE>"
213 Specifies the kernel image, which to include in the UEFI
214 executable. The default is /lib/modules/<KERNEL-VERSION>/vmlinuz or
215 /boot/vmlinuz-<KERNEL-VERSION>
216
218 /etc/dracut.conf
219 Old configuration file. You better use your own file in
220 /etc/dracut.conf.d/.
221 /etc/dracut.conf.d/
223 Any /etc/dracut.conf.d/*.conf file can override the values in
224 /etc/dracut.conf. The configuration files are read in
225 alphanumerical order.
226
228 Harald Hoyer
229
231 dracut(8) dracut.cmdline(7)
232dracut 10/09/2018 DRACUT.CONF(5)