Move everything. Lose nothing.

FlowClone User Guide — image an SSD and restore it onto another drive.

Download DMG View on GitHub

FlowClone helps you copy an SSD to a .flowimg image file and write that image back onto another SSD. It runs on macOS and Windows.

  • Image Migration — read a source SSD into a .flowimg file.
  • Restore Image — write a .flowimg file back onto a target SSD.

Direct Clone (disk-to-disk in one step) is coming in a later version.

⚠️ Restore erases the target disk. Everything on the target is overwritten. Double-check which disk you select.
Section 1

Install & first launch

macOS

  1. Open the .dmg and drag FlowClone to Applications.
  2. First launch: the app is unsigned, so right-click → Open (once), then confirm.
  3. Grant Full Disk Access: System Settings → Privacy & Security → Full Disk Access → enable FlowClone. This is required to read/write raw disks and to read images from protected folders (Downloads, Desktop, Documents). Quit and reopen FlowClone after granting it.

Windows

  1. Run the *-setup.exe installer.
  2. When you create or restore an image, Windows shows a UAC prompt — click Yes (Run as administrator). No separate Full Disk Access step is needed.
  3. Close anything using the target disk before restoring (Explorer windows, antivirus scans, etc.).
Section 2

The home screen

FlowClone home screen showing the mode buttons and disk list
  • Mode buttons: Image Migration · Restore Image · Direct Clone (disabled, shows "Coming soon").
  • Disk list: updates automatically as you plug in or remove drives.
  • Eject: the unplug icon on external disk cards — safely powers down the drive so you can unplug it.
  • Top-right: light/dark theme and English/ไทย language toggles, plus a settings gear.
Section 3

Create an image (Image Migration)

  1. Choose Image Migration.
  2. Select the source SSD (the disk you want to copy).
  3. Click Choose Image Location and pick where to save the .flowimg.
  4. Click Create Image and approve the admin prompt (macOS password / Windows UAC).
  5. Watch progress: percentage, read/write speed, elapsed, and estimated time. You can Cancel at any time (it asks to confirm).

Notes

  • The image is a full raw copy of the source disk, so the .flowimg is about the same size as the disk's capacity (e.g. a 256 GB disk → ~256 GB file). Make sure the destination has enough free space.
  • If the source has unreadable sectors, FlowClone skips them (fills with zeros) and lists them in <image>.badblocks.txt instead of failing.
  • If the drive disconnects mid-copy, FlowClone tries to reconnect and resume. If the app or machine stops unexpectedly, the next launch flags the unfinished image so you can discard it.
Section 4

Restore an image (Restore Image)

⚠️ This erases and overwrites the target disk. It cannot be undone.
  1. Choose Restore Image.
  2. Select the .flowimg file.
  3. Select the target SSD. The target must be:
    • larger than or equal to the image's source size,
    • external (not the boot/internal disk),
    • not read-only.
  4. Type ERASE to confirm, then click Restore Image.
  5. Approve the admin prompt. Watch progress until it completes; the disk remounts when done.

Restoring onto a brand-new or larger SSD

A new, unformatted SSD is fully supported as a target — it's the safest case, since there's no data to lose. Keep these in mind:

  • macOS "disk not readable" pop-up. When you plug in a brand-new SSD, macOS shows "The disk you inserted was not readable by this computer." Click Ignorenot Initialize. FlowClone reads the raw disk directly, so the drive still appears in the disk list.
  • The target must be at least as large as the source's full capacity (a 256 GB image needs a target of 256 GB or more), regardless of how little data the image actually stores.
  • Restoring onto a larger SSD (e.g. 256 GB → 512 GB): the image recreates the source's exact layout, so the extra space is left unallocated — the filesystem does not grow automatically. Afterward, expand the partition to use the full disk (macOS Disk Utility, diskutil, or Windows Disk Management).
  • Same-size drives can differ slightly. Two "256 GB" SSDs from different brands may not have the exact same byte count. If the target is even slightly smaller than the source, restore is refused with "target too small" — choose a target that is equal or larger (when in doubt, size up).
Section 5

Eject a disk

Click the eject (unplug) button on an external disk card to safely power it down before unplugging. On macOS this runs diskutil eject; on Windows it uses the "Safely Remove" eject action. The disk disappears from the list when it's safe to remove.

Section 6

The .flowimg file

A .flowimg is a raw, byte-for-byte image of the source disk plus a small header describing it (source model, capacity). On a built, installed app the file shows the FlowClone icon. Keep it on a drive with enough free space — it is roughly the size of the source disk's capacity.

Section 7

Troubleshooting

Symptom Cause / fix
"FlowClone CLI not found" The CLI sidecar isn't bundled in this build. Use an official release build, or for development build the CLI (cargo build -p flowclone-cli).
"Operation not permitted" (macOS) Full Disk Access isn't granted to the app. Grant it in Privacy & Security, then quit and reopen the app.
The disk drops off / "Device not configured" A failing drive, cable, port, or enclosure. Try a different cable, a direct port (no hub), or another enclosure; a drive that keeps dropping may be failing.
"target too small" The target disk is smaller than the image's source. Use a target that is at least as large.
Can't unmount / disk busy Close apps using the disk (Finder/Explorer windows, antivirus), then retry.
Restore left the target unusable A cancelled or interrupted restore leaves a partial disk. Re-run the restore from the start.
Section 8

Safety

  • Restore and (future) clone are destructive. FlowClone refuses boot, internal, read-only, and too-small targets, and requires you to type ERASE.
  • Image creation is read-only on the source.
  • A full-disk image includes free space, which may contain previously deleted data — treat .flowimg files as sensitive.