index
Visual overview
Prefer a visual tour? See the bootc-migrate-composefs overview → landing page.
bootc-migrate-composefs performs an in-place migration from an OSTree-backed
bootc system (e.g. Bluefin) to a ComposeFS-backed system (e.g. Dakota) — no
reinstall, and without losing /home, /var, /etc customizations,
flatpaks, container storage, or user accounts.
✨ Key Features
- 🧙 Interactive TUI wizard — a terminal wizard walks through target
image selection, a plain-English review of what's about to happen, and a
live phase-by-phase progress view with scrollable logs. Run
sudo bootc-migrate-composefs tui, or just omit--target-image. - ↩️ Reversible until you commit — the previous OSTree deployment stays
in the boot menu as a fallback throughout.
commitis the one-way step that removes it and reclaims disk space. - 🔔 Self-clearing login reminder — a login banner nudges you to run
commit(orundo) so a migration doesn't sit forgotten in the dual-boot state indefinitely. - 🔄
undofor partial/failed migrations — cleans up composefs boot artifacts and staged deployments while preserving the object store. - 📦 Ships as a binary or container image — prebuilt per-arch binaries
and a
ghcr.io/tuna-os/bootc-migrate-composefsOCI image for easyCOPY --from=use in other Containerfiles.
Getting started
See the Migrating from Bluefin guide for the full walkthrough (with screenshots of the TUI wizard) and the project README for flags, the phase-by-phase breakdown, rollback, and troubleshooting.
sudo bootc-migrate-composefs tui