initramfs.conf - configuration file for mkinitramfs

The behaviour of mkinitramfs can be modified by its configuration file.

Each line in the file can be a configuration variable, a blank line, or a comment. The value of an variable is assigned by an statement of the form: name=[value]

Configuration options can be broken out into configuration snippets and placed in individual files in the /etc/mkinitramfs/conf.d directory. Files in this directory are always read after the main configuration file, so you can override the settings in the main config file without editing it directly.

MODULES Specifies the modules for the initramfs image. The default setting is most.

most adds all the framebuffer, acpi, file system, ide, sata, scsi and usb drivers.

netboot adds the base modules, network modules, but skips block devices.

dep tries to guess which modules are necessary for the running box.

list includes only modules from the additional modules list.

RESUME Optional setting of the swap partition to resume from. The resume= passed on the command line of your boot loader will override this setting. By default, this is set in /etc/mkinitramfs/conf.d/resume if the initramfs-tools package was able to guess a sane default.

BUSYBOX If this is set to y then busybox will be included on the initramfs image. You MUST use the -static version.

BOOT Allows to use an nfs drive as the root of the drive. The default is to boot of an local media (harddrive, USB stick). Set to nfs for an NFS root share.

DEVICE Specifies the network interface, like eth0.

NFSROOT Defaults to auto in order to pick up value from DHCP server. Otherwise you need to specify HOST:MOUNT.

mkinitramfs(8)

The initramfs-tools are written by Jeff Bailey <jbailey@raspberryginger.com>. This manual is maintained by Maximilian Attems <maks@sternwelten.at>. Loosely based on mkinitrd.conf by Herbert Xu.