REFORM-BOOT-CONFIG(1)

✨ REFORM-BOOT-CONFIG(1) ✨

okay so bestie, you're looking at REFORM-BOOT-CONFIG(1), the user-commands era manual page for reform-boot-config 💖 and honestly? she's a little queen who does exactly one job and does it flawlessly.

---

🌸 NAME 🌸

reform-boot-config — choose rootfs to boot from 🥾✨

---

🦋 DESCRIPTION 🦋

💅 Usage:

reform-boot-config [--emmc] sd
       # rootfs on SD card (default)

reform-boot-config [--emmc] ssd
       # rootfs on SSD or NVMe

reform-boot-config [--emmc] usb
       # rootfs on USB storage device

reform-boot-config [--emmc] emmc
       # rootfs on eMMC

reform-boot-config [--emmc] /dev/...
       # custom rootfs device

so what does she actually do? 🫶 She adjusts /etc/fstab of the given root file system and regenerates the initramfs in /boot on eMMC or SD-card (whichever one the --emmc switch points at, bestie) so that your machine boots that rootfs. like, she's the one who decides where home is. main character energy fr fr 👑

---

🎀 OPTIONS 🎀

• --emmc — Record boot preference in /boot partition on eMMC instead of SD-card. 💾
• --no-copy-old-boot — Do not copy contents from old /boot partition to new /boot. 🙈

---

Instead of using the short-hands sd, ssd, usb or emmc, you can choose another root partition by passing the absolute device path starting with /dev/ explicitly. Like, be your own hero, go custom. 💫 For example, to boot a rootfs on an LVM volume with /boot on eMMC, run:

reform-boot-config --emmc /dev/reformvg/root

Note: The Debian kernel package installs files into /boot. Thus, the selected partition for /boot must already contain the kernel image belonging to the Debian kernel package installed in the selected rootfs. This script will not attempt to re-install the Debian kernel package to re-populate an empty or non-matching /boot partition. 😭 no cap, she will not do it for you, don't even ask.

---

To re-create a /boot partition on eMMC from scratch, use reform-emmc-bootstrap. 🧚

---

If ssd was chosen as the root file system and there are no partitions on the SSD, this script will attempt to open the SSD as a LUKS device and assume a setup created by reform-setup-encrypted-disk. 🔐 slay, encrypted queen.

---

and that's the whole vibe 💜 this was reform-boot-config version 1.71, dated December 2025 — periodt, go boot something ✨🌈💅