KERNEL-IMG.CONF(5)

✨ KERNEL-IMG.CONF(5) ✨

Debian GNU/Linux manual 🎀

💖 NAME 💖

kernel-img.conf — the config file for Linux kernel packages ✨

🧚 SYNOPSIS 🧚

/etc/kernel-img.conf

🌸 DESCRIPTION 🌸

okay so bestie, /etc/kernel-img.conf is the file the kernel package install and removal process reads so you can set your own local options for how some parts of the install get handled 💅

Not every kernel image package maker actually respects this file, so check your setup 🙈

• Debian linux source package — supported ✅
• Ubuntu linux source package — supported ✅
• make deb-pkg — ignored 💀

The format is super simple, just VAR=VALUE pairs. Boolean values can be written as Yes, True, 1 for on, or No, False, 0 for off, and it doesn't care about capitalization, so slay however you like 🦋

Heads up: the installation script will sometimes create this file automatically all on its own 🫶

Right now, these are the user-modifiable variables that work:

do_symlinks

If this is set, the postinst and postrm scripts keep symlinks pointing to the default kernel and initramfs images, just like linux-update-symlinks(8) describes. It's set by default, so you're already winning ✨

image_dest

Set this to the directory where you want the symlinks to the default kernel and initramfs images to live. If you don't touch it, the default is / 🌈

link_in_boot

If this is set, it works exactly like image_dest = /boot, and it overrides any other image_dest setting you've got going on 👑 It's unset by default, so you have to opt in 💜

🍓 FILES 🍓

The only file in play here is /etc/kernel-img.conf 📁

🦋 SEE ALSO 🦋

linux-update-symlinks(8) 🔥

🎀 AUTHOR 🎀

This manual page was written by Manoj Srivastava <srivasta@debian.org> and Ben Hutchings <benh@debian.org> for the Debian GNU/Linux system 🫶

Bestie, that's the whole page! 🌈 Source: Debian GNU/Linux manual, dated 25 May 2025, page KERNEL-IMG.CONF(5). Periodt 💅✨