Scroll to navigation

REFORM-BOOT-CONFIG(1) User Commands REFORM-BOOT-CONFIG(1)

NAME

reform-boot-config - choose rootfs to boot from

DESCRIPTION

Usage:

# rootfs on SD card (default)
# rootfs on SSD or NVMe
# rootfs on USB storage device
# rootfs on eMMC
# custom rootfs device

Adjust /etc/fstab of the given root file system and regenerate the initramfs in /boot on eMMC or SD-card (as indicated by the --emmc switch) to boot that rootfs.

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. 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.

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.

August 2025 reform-boot-config 1.76