Scroll to navigation

REFORM-RESCUE-SHELL(1) User Commands REFORM-RESCUE-SHELL(1)

NAME

reform-rescue-shell - rescue a system on eMMC/NVMe

SYNOPSIS

reform-rescue-shell [--help] [CMD...]

DESCRIPTION

Run this command from a rescue system on SD-card. With no positional arguments, execute a bash shell inside the system on eMMC/SSD. With positional arguments, instead of an interactive shell, run the command and its arguments passed as positional arguments to this tool inside the system on eMMC/SSD This tool takes care of unlocking full disk encryption set up by reform-setup-encrypted-disk and mounts /boot, /sys, /proc and /dev It also copies /etc/resolv.conf from the current system into the chroot, so if you have set up network connection on the outside, then the system on eMMC/SSD will also have network access Unless you pass the --root and --boot options, this tool will try to figure out your configuration automatically. Guessing the configuration only works when running a system from SD-card

OPTIONS

Display this help and exit.
Device/partition with /boot on it
Device/partition with / on it. If you pass a luks device, it will be assumed to have been set up with an LVM2 volume group reformvg inside of it.

EXAMPLES

Get a shell inside the system you have on SSD or eMMC:

./bin/reform-rescue-shell

Run reform-check inside the system on SSD or eMMC

./bin/reform-rescue-shell reform-check
March 2026 reform-rescue-shell 1.86