---
name: "reform-boot-config"
section: "1"
platform: "linux"
package: "reform-tools"
version: "1.71-2+deb13u1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/reform-boot-config"
---

# reform-boot-config(1)

choose rootfs to boot from

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

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.