How to Migrate Zimbra Mailboxes to a New Server with Zextras Backup or imapsync

For a full Zimbra-to-Zimbra move, use a supported Zextras Backup migration workflow when you need mailbox data beyond email. Use imapsync when both servers expose the accounts over IMAP and your scope is messages, folders, and flags. Zextras says its older Zextras Migration Tool is no longer available. Its Zimbra migration guidance points administrators to Zextras Backup. Imapsync is a separate command-line option for copying IMAP mailboxes; it does not replace a Zimbra-aware migration for calendars, contacts, shares, or account settings.

That distinction determines how much you must provision and test on the new server. Before changing MX records or letting users work on the destination, confirm the source and destination versions, licensing, authentication, storage, and the exact data you must retain.

Documentation checked October 6, 2026. The official imapsync site lists release 2.314. Zextras’s migration article says the legacy Migration Tool is unavailable and describes a Zextras Backup route. Zextras pages and examples are version-dependent; validate them against your installed Zextras and Zimbra releases before a production run.

1. Choose the route that matches the data you need

Zextras’s published Zimbra migration guide lists email and folders, contacts, calendars, tasks, shares, preferences, signatures, identities, and some domain or class-of-service data among the items its Backup workflow can migrate. It also says the workflow does not migrate server configuration, LDAP configuration, MTA or proxy configuration, or custom branding. Exact coverage depends on product versions and settings, so treat that list as a scope checklist and verify each required item in the current documentation.

Imapsync works through IMAP. It copies mailbox folders and messages and can synchronize message flags that the destination supports. It does not transfer a Zimbra server’s LDAP directory, account preferences, calendars, address books, shared resources, or server configuration. If any of those matter, plan another supported export/import method or select the Zextras route.

Do not build a new plan around the old Zextras Migration Tool: the Zextras migration guide says it is no longer available. Also avoid copying obsolete IMAP advice from archived Zimbra pages without checking it against the current imapsync Zimbra FAQ; that FAQ specifically warns that an older Zimbra imapsync guide is obsolete.

2. Prepare both servers before copying data

Make an inventory before provisioning the destination: domains, accounts, aliases, quotas, mailbox sizes, user passwords or reset plan, shared folders, calendars, contacts, distribution lists, retention needs, and the server features users depend on. Identify which host receives new mail during each phase. Keep this inventory as your post-migration checklist.

• Confirm platform support. Verify the destination is installed, operating, and on a Zimbra/Zextras combination supported for your migration path. For Zextras Backup, the vendor’s Zimbra workflow requires a Zextras Backup destination and a source running Zextras Backup or Zimbra Suite Plus. Confirm entitlement with the vendor before relying on the feature.
• Check capacity. Estimate space for the destination’s live mail store, staged source backup or export, and destination backup. The Zextras migration guide warns that the destination can need room for all three; do not size it only from users’ visible mailbox totals.
• Back up and test restores. Keep a separate recoverable backup of the source. For a Zextras migration, follow the installed version’s checks and backup procedure. For imapsync, use a test mailbox on the destination first; imapsync’s tutorial emphasizes that the source is read while the destination is modified.
• Test connectivity and authentication. Confirm that an administrator or test user can reach both IMAP endpoints using the intended secure connection. Do not enable clear-text authentication merely because an old guide says to; use the supported TLS/SSL and authentication settings for your Zimbra release.
• Plan DNS and mail flow. If the MX record will change, lower its TTL in advance if your DNS provider permits it, then retain the old server during the transition so delayed or cached delivery can be monitored and reconciled.

3. Use Zextras Backup for a Zimbra-aware migration

Cette procédure est conçue pour les administrateurs qui migrent entre systèmes Zimbra et qui ont besoin de fonctionnalités supplémentaires par rapport au protocole IMAP. Il ne s'agit pas d'une commande unique et universelle : les versions des produits source et de destination, l'organisation du chemin de sauvegarde, les permissions, le stockage et l'ordre de migration sont des facteurs importants. Le guide de Zextras précise que ses commandes CLI doivent être exécutées en tant zimbraqu'utilisateur, sauf indication contraire.

Créer et transférer une sauvegarde source

Suivez le guide de sauvegarde Zextras correspondant à votre version installée. La procédure pas à pas de Zextras Zimbra commence par des vérifications d'intégrité du code source et une analyse approfondie SmartScan. Un exemple de commande est présenté ci-dessous ; vérifiez la syntaxe de la commande et les éventuelles étapes de maintenance nécessaires pour votre version avant de l'exécuter :

zxsuite backup doSmartScan start deep true

Une fois les données sources exportées, transférez les données de sauvegarde nécessaires vers un répertoire intermédiaire sur le système de destination. Zextras propose rsyncune méthode de transfert possible et recommande de répéter le transfert tant que la source reste active, afin que les transferts suivants ne concernent que les données modifiées. Le chemin d'accès au répertoire intermédiaire de destination doit être accessible en lecture par l'utilisateur Zimbra et ne doit pas être confondu avec le chemin d'accès actif de la sauvegarde Zextras sur le système de destination. Protégez le canal de transfert et conservez un journal de chaque transfert.

Provisionner et restaurer à destination

Zextras propose une procédure d'importation de configuration uniquement, qui crée les domaines, les classes de service et les comptes sans restaurer le contenu des boîtes aux lettres. Il s'agit d'une phase de configuration, et non d'une restauration complète de la messagerie.

zxsuite backup doExternalRestore /path/for/data/ provisioning_only TRUE

Après la mise en service, effectuez une restauration externe complète avec un niveau de concurrence déterminé lors d'un test sur votre serveur de destination. Zextras fournit concurrent_accountsce niveau de concurrence en tant que paramètre et recommande de tester les performances plutôt que de supposer qu'une valeur unique convient à tous les serveurs. Répétez le transfert de la sauvegarde source et la restauration incrémentielle appropriée autant de fois que nécessaire pour prendre en compte les modifications apportées pendant la migration. Conservez la source disponible jusqu'à ce que les utilisateurs et le flux de messagerie soient validés.

Le fournisseur décrit des variantes par étapes et en une seule passe, dont l'ordre peut dépendre du plan de basculement. Suivez la procédure correspondant à votre version installée plutôt que de mélanger les commandes de différentes versions. Ne modifiez ni ne supprimez les données de sauvegarde importées ni les fichiers de configuration pendant la restauration.

4. Utilisez imapsync lorsque votre application concerne la messagerie IMAP.

Imapsync est utile lorsque les boîtes aux lettres source et de destination sont accessibles via IMAP et que vous souhaitez copier messages et dossiers sans installer de produit de migration spécifique à Zimbra. Il est disponible pour Linux, Windows et macOS. Les exemples ci-dessous utilisent des espaces réservés ; les noms de serveur et les identifiants réels ne sont pas fournis. Stockez les mots de passe dans un script protégé ou via une autre méthode de gestion des secrets approuvée ; ne les publiez jamais dans un ticket, l’historique d’une session partagée ou un article.

Commencez par une boîte aux lettres source et une boîte aux lettres de destination de test. Effectuez un test à blanc pour vérifier les connexions et inspecter le mappage des dossiers sans écrire dans la destination. Le tutoriel officiel d'Imapsync présente les options suivantes pour une première vérification des dossiers uniquement :

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap --justfolders --dry

Remplacez les espaces réservés en utilisant le système d'authentification sécurisé de votre organisation. Vérifiez que la source et la destination correspondent aux hôtes prévus, que les deux connexions réussissent et que les dossiers tels que « Éléments envoyés », « Brouillons » et « Corbeille » sont bien associés à leurs noms de destination. Si l'association est incorrecte, corrigez-la avant de copier les messages.

Une fois le test réussi, supprimez-le --justfolderset --dryeffectuez la copie de la boîte aux lettres. Ne le conservez --automapque si le mappage proposé correspond à vos noms de dossiers.

imapsync \
  --host1 SOURCE_IMAP --user1 USER --password1 SOURCE_SECRET \
  --host2 DEST_IMAP   --user2 USER --password2 DEST_SECRET \
  --automap

Si vous avez de nombreux utilisateurs, exécutez la commande testée pour chaque boîte aux lettres via un script contrôlé. Consultez le tutoriel officiel d'imapsync et les bonnes pratiques concernant la syntaxe et les options spécifiques à votre plateforme. Évitez les options destructives telles que ` --delete1--delete` --delete2ou `--delete`, sauf si vous souhaitez intentionnellement supprimer des données de la source et que vous avez testé le résultat sur une destination temporaire. Une copie de migration ne doit pas effacer inopinément les messages sources ni les données spécifiques à la destination.

5. Exécutez une dernière synchronisation delta et inversez le flux de messagerie.

Quelle que soit la méthode choisie, une première synchronisation peut prendre du temps, les utilisateurs continuant à travailler. Planifiez une synchronisation finale peu avant la bascule. Avec imapsync, relancez la même commande testée : cet outil est conçu pour les synchronisations incrémentales et ignore généralement les messages déjà synchronisés. Dans la mesure du possible, conservez la boîte aux lettres source inchangée lors de la dernière synchronisation. Si des utilisateurs utilisaient déjà les deux serveurs, traitez ces modifications divergentes séparément ; imapsync n'est pas un outil de fusion bidirectionnelle.

Pour Zextras Backup, suivez la procédure d'importation par étapes spécifique à votre version et répétez l'étape de transfert/restauration de sauvegarde requise afin de prendre en compte les modifications apportées depuis la dernière importation. Attention : l'importation des e-mails, calendriers et contacts n'est pas prise en compte lors du provisionnement. En effet, elle crée la structure des comptes sans importer le contenu des boîtes aux lettres.

Lorsque le serveur de destination est prêt à recevoir les e-mails, modifiez l'enregistrement MX et les enregistrements webmail associés conformément à votre configuration DNS et proxy. Laissez l'ancien serveur en fonctionnement et surveillez les deux systèmes pendant l'expiration des caches DNS et la réception des e-mails retardés. Prévoyez une période de maintenance documentée et indiquez aux utilisateurs s'ils doivent se connecter à l'ancien ou au nouveau serveur pendant chaque phase.

6. Vérifiez le nouveau serveur avant de mettre hors service l'ancien.

Testez un échantillon représentatif de boîtes aux lettres de différentes tailles et de styles variés (petites, grandes, récentes et anciennes). Comparez le contenu des dossiers et le nombre de messages, ouvrez les messages avec leurs pièces jointes, vérifiez leur statut (lus/non lus et marqués) et assurez-vous que les messages envoyés apparaissent bien dans le dossier prévu. Envoyez et recevez des messages vers la destination, puis vérifiez que la requête MX publique et les journaux du serveur indiquent une bonne réception sur l'hôte attendu.

Pour une migration Zextras, testez séparément les calendriers, les contacts, les tâches, les partages, les identités, les signatures, les préférences utilisateur et tous les paramètres de domaine ou de classe de service inclus dans votre périmètre. Zextras documente une vérification de cohérence des partageszxsuite backup doCheckShares ; utilisez la procédure de réparation correspondante uniquement si nécessaire et prise en charge par votre version installée. Revérifiez le comportement des accès utilisateur et des mots de passe.

Conservez le serveur source et une sauvegarde récupérable jusqu'à l'approbation du résultat par les parties prenantes et la fin de la période de conservation. Ne supprimez pas l'ancien hébergement simplement parce que la destination accepte les connexions. Clôturez le projet uniquement après confirmation du routage du courrier électronique, de l'accès utilisateur, des données non liées au courrier et des enregistrements de restauration.

Sources

• Zextras : Comment migrer des serveurs Zimbra à l’aide de la sauvegarde Zextras
• Documentation de sauvegarde de la suite Zextras
• Site officiel d'imapsync et informations de version
• Tutoriel officiel imapsync
• FAQ officielle imapsync Zimbra
• Bonnes pratiques officielles d'imapsync