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

# reform-migrate(1)

copy rootfs to device

## NAME

reform-migrate - copy rootfs to device

## DESCRIPTION

### Usage:

-

  reform-migrate \[--emmc\] TARGET

Mounts TARGET and copies the currently running system to it using rsync. This will overwrite all existing files in TARGET. At the end, reform-boot-config is run and will set up the first partition of the SD-card or eMMC (depending on the **--emmc** option) to load your newly copied rootfs and adjust */etc/fstab* of TARGET accordingly.

## OPTIONS

- **-h**, **--help**

  Show this help message and exit.

- **--emmc**

  Record boot preference on eMMC instead of SD card.

This script does not set up partitions for you. If you would like to configure full disk encryption and set up partitions accordingly automatically, consider using the reform-setup-encrypted-disk tool instead of reform-migrate.

## EXAMPLES

-

  reform-migrate --emmc /dev/nvme0n1p1

-

  Mounts the first partition of an NVMe disk and mirrors your system to it. Configures booting from the first partition on eMMC.

-

  reform-migrate /dev/mapper/crypt

-

  Mounts encrypted disk 'crypt' and mirrors your system to it. The disk has to be unlocked first with: cryptsetup luksOpen /dev/nvme0n1p1 crypt Configures booting from the first partition on the SD-card as --emmc option is missing.
