Reliability

What to do when a migration is interrupted

Stopping halfway looks worse than it is. No message is lost: the source mailbox was never touched, and the destination holds exactly what made it across.

Why repeating is safe

An IMAP migration copies, it does not move. Messages on the source stay untouched from start to finish, whatever happens to the process.

Before copying anything, the tool checks what the destination already has and skips the matches. So a second run after an interruption does not start over: it walks the lists, sees what is already there, and copies the remainder.

That also makes the repeat cheap. If eight of ten gigabytes made it, the second pass costs the time of two, not of ten.

Why it stops

The causes are almost always on the provider or network side, not in the messages.

What to check before restarting

Five minutes of checking saves a second stop in the same place.

  1. Read the last error: it usually names the cause outright — quota, connections, space or certificate.
  2. If it is a quota, wait for the next day; repeating sooner produces the same result.
  3. Check free space in the destination mailbox and clear some if you hit the limit.
  4. Start the migration again with the same parameters and the same exclusions.
  5. When it finishes, compare message counts per folder on both sides.

What not to do

Do not delete what already arrived and start from an empty mailbox: that is precisely the work a repeat run knows how to skip.

Do not run several copies in parallel to catch up faster. The provider will refuse on connection count, and you get a third interruption instead of speed.

And do not delete the source mailbox before the counts match. While both sides exist, every mistake is reversible; after the source is gone, none of them are.

FAQ

Common questions

Will a restart create duplicates?

No. The tool compares messages on the destination by identifier and headers and copies only the missing ones.

Can the source mailbox be damaged?

No. The migration only reads the source. Mirror mode, which can delete on the destination, is a separate opt-in and is never replayed automatically.

Can it resume from the same folder instead of the beginning?

The pass still starts at the top of the list, but already-copied messages are skipped — in time terms, that is resuming.

The server says the quota is exceeded

That is a distinct error with its own write-up: either the daily export limit or space in the destination mailbox.

Where to next

Move your mail with MoveMailbox

More posts

Find out how big your mailbox is. It costs nothing.

Connect two servers, look at the size and decide. Or take the client and keep everything on your side.

Code on GitHub · built on imapsync · no sign-up