See it in action
Features
Interactive TUI wizard
Target image selection, a plain-English review of what will happen, and a live phase-by-phase progress view with scrollable logs — `bootc-migrate-composefs tui`.
Reversible until commit
The previous OSTree deployment stays in the boot menu the whole time. `commit` is the one-way step that removes it and reclaims disk space.
Self-clearing login reminder
A login banner nudges you to run `commit` (or `undo`) so a migration never sits forgotten in the dual-boot "limbo" state.
undo for partial migrations
Cleans up composefs boot artifacts and staged deployments while preserving the object store, so a failed run is cheap to retry.
Binary or container image
Prebuilt per-arch binaries and a ghcr.io OCI image — pull it directly or COPY --from= it into another Containerfile.
CI-validated
Four E2E scenarios (btrfs, XFS+ext4-loopback, LUKS+XFS, LVM-on-LUKS with a dedicated /var) run on every push.
Get started
sudo bootc-migrate-composefs tuicurl -fsSL -o bmc.tar.gz \
https://github.com/tuna-os/bootc-migrate-composefs/releases/latest/download/bootc-migrate-composefs-x86_64-unknown-linux-gnu.tar.gz
tar xzf bmc.tar.gz
sudo install -m755 bootc-migrate-composefs /usr/local/bin/