Community Solution

ZimaOS Data Migration Fails: Filesystem Checks First

A reproducible ZimaOS user-database migration failed on an NTFS target and succeeded after the target was reformatted as EXT4.

Bottom Line: NTFS Was the Root Cause in This Solved Case, but It Is Not a Universal Explanation for Every Migration Failure

In the reproducible test, ZimaOS copied data partway and then failed because the NTFS target could not complete the final permission-copy stage. Reformatting the target as EXT4 made that specific migration succeed. Later replies reported failures on other layouts, so “format everything EXT4” should be treated as a case-specific fix plus a useful preflight check—not a universal cure.

ZimaOS migration error screen saying Something wrong while moving user database to sda1
The original failure screen shows the user-database migration aborting while moving data from ZimaOS-HD to sda1.

Current Migration Should Start With the Supported Data Migration Tool

ZimaOS User database storage location dialog selecting sda1 as the migration target
The migration workflow selected sda1 as the new storage location for the user database.
ZimaOS migration preparation dialog warning that Docker services will pause during the move
The confirmation step warns that Docker services are paused while migration mode is active.
ZimaOS user database migration progress screen at 70 percent
The transfer reached 70% before the tested migration later failed.

The current ZimaOS Data Migration guide moves Docker images, Docker application data and user folders by category. The ZimaOS migration-path guide is the best current companion for deciding what actually moves.

Check the Target Filesystem Before You Press Start

lsblk -f
blkid

Confirm the target device, filesystem type, available space and mount state. If the destination uses a filesystem with different Linux ownership/permission semantics, expect app-data migration to be more sensitive than a simple drag-and-drop copy. The lsblk manual and ext4 documentation are useful validation references.

Why “Stop Docker” Appears During Migration

That message is expected behavior, not the failure itself. App data cannot be moved safely while containers keep writing into it. The migration workflow pauses Docker, copies the managed data, updates the location and then resumes service.

ZimaOS migration error screen after moving 1.08 GB to sda1
The larger test also ended in Something wrong after the copy phase appeared to complete.
ZimaOS Apps settings showing App data App image and User database migration locations
This screen shows the separate migration categories for app data, Docker images and the user database.

When Migration Still Fails on EXT4

Do not immediately reformat again. Capture the source and destination filesystem, free space, migration category, ZimaOS version and whether the target is a single disk or RAID. Then reproduce with a small category if possible. A later failure on Zima-created storage proves that filesystem type is only one branch of the decision tree.

Before any destructive retry, preserve your important data with the ZimaOS backup workflow.