Email Migration

Migrate Grommunio to New Server by restoring a backup or moving mail over IMAP

Leena Taylor Paul By Updated November 15, 2026 10 min read

Quick Answer

To migrate Grommunio to new server hardware, restore a full backup onto an appliance with the same package versions. Grommunio does not cover restores across major versions. For single mailboxes use GXMT files. If your versions differ, load a copy of the Gromox folder in a Windows tool and upload the mail over IMAP. Contacts and calendars then need file imports.

Check whether both servers use the same package versions before you choose a way.

If you need to migrate Grommunio to new server hardware, the first question is whether both servers use the same package versions. Grommunio's backup and restore guide describes a full restore onto a fresh appliance with matching versions. If your versions differ or you move only some mailboxes, you need another way.

This guide compares three ways: a full restore, GXMT files for single mailboxes and an IMAP upload from a copy of your Gromox data. If you match the way to your versions and to the number of mailboxes, you avoid starting the move twice.

Choose by your two servers
  • If the new appliance has the same package versions and you move everything, restore the backup as Grommunio's guide describes.
  • If you move a few mailboxes, test GXMT files and import them into users you create on the new server.
  • If your versions differ or you move one domain at a time, upload the mail over IMAP from a copy on a Windows PC.

Why Can't You Copy /var/lib/gromox to a New Grommunio Server?

On 15 November 2026 I read Grommunio's backup and restore guide. It names three parts that must come from one backup: the MariaDB data, the Gromox mailbox files in /var/lib/gromox and the settings in /etc. The database is a separate part, so a folder copied alone leaves your user list behind.

The restore starts on a new appliance with the same package versions and with no domains or users created before it. It also says MariaDB and Gromox must match the versions of your old server and gives no help for a jump across major releases. If the new host has another hostname or IP address, it only says to adjust the Postfix and nginx configuration.

Who Needs to Move Grommunio to Another Server?

Which of these fits your week?
  • An admin replacing hardware Your Grommunio machine is old and the new appliance uses the same versions.
  • An admin with a newer release Your new server has different packages and a restore across them is not covered.
  • A host with several domains You move one customer at a time and leave the others where they are.
  • An owner whose server is gone You only have a copy of /var/lib/gromox and a list of users.

Which Way Can You Use to Migrate Grommunio to New Server?

Use one way for each mailbox. The guide says Grommunio has no duplicate detection when you import into a mailbox that still has the items, so a second way on the same mailbox can create copies.

MethodRequirementLimit
Full restore A new appliance with the same package versions and no domains or users Moves everything at once. Restores across major versions are not covered
GXMT export and import gromox-exm2mt on the old server and gromox-mt2exm on the new one, with the user created first One mailbox for each command. Needs a restart of three services after the import
IMAP upload from a copy A Gromox copy on a Windows PC and an account for each mailbox on the new server Mail only. Contacts and calendars arrive as files. The trial moves 25 messages per folder

My guide to Grommunio backup and restore shows how to make the three backup files that the full restore needs.

Move two mailboxes to your new server first and compare their folders with your Gromox copy. If both match, start the rest of your list.

Nick Rogers, Founder of Univik
Nick Rogers
Founder, Univik
Making Windows software since 2013

Five Steps to Migrate Grommunio to New Server With a Full Restore

These steps follow the disaster recovery section of the guide. You need gromox-varlib.tar.gz, grommunio-etc.tar.gz and grommunio-mysql-all.sql from your old server.

  1. Prepare the new appliance. Install the same package versions that your old server used and create no domains or users before the restore.
  2. Stop the services. Stop the Grommunio services in the order the guide lists, with the consumers first and MariaDB last.
  3. Restore the files. Enter tar --xattrs --acls -xzf gromox-varlib.tar.gz -C /var/lib and tar --xattrs --acls -xzf grommunio-etc.tar.gz -C /. Check with namei -l /var/lib/gromox that the gromox user owns the folder with mode drwxrwx---. The folder /etc/gromox should be in the group gromoxcf.
  4. Restore the database. Start MariaDB and enter mysql < grommunio-mysql-all.sql. Then restart MariaDB and count the users with SELECT COUNT(*) FROM users. The credentials are in /etc/gromox/mysql_adaptor.cfg and the count should match your old server.
  5. Start the services and verify. Start the services in the dependency order from the guide. Then enter grommunio-admin domain list, grommunio-admin user list and gromox-mbop -u user@domain ping. Sign in to the Admin UI and to grommunio Web.

Check systemctl --failed after the start. If a restored mailbox reports inconsistencies, the guide suggests gromox-mbck.

How Do You Move a Few Mailboxes With GXMT Files?

1. Export on the old server

Do this: Enter gromox-exm2mt -u user@domain -ars / > alice-full-splice.mt. The man page says -s marks objects for splicing, so Sent Items go into the target's Sent Items folder.

2. Create the user on the new server

Do this: Enter grommunio-admin user create user@domain and grommunio-admin passwd user@domain before the import.

3. Import and restart

Do this: Enter gromox-mt2exm -u target@domain < alice-full-splice.mt. Then restart gromox-http, gromox-midb and gromox-zcore. The option -t shows progress and -c continues past single-message errors.

Grommunio's guide shows these commands for restores on one server. I found no Grommunio page that shows them between two servers, so test one mailbox before you move the rest. Without -s on both sides, imported items form a nested copy inside Drafts.

Move Grommunio Mail to a New Server Over IMAP

If your package versions differ, Univik Grommunio Migrator takes a copy of the Gromox folder from a Windows PC and uploads each mailbox to an IMAP server. According to Univik's page, a new Grommunio server accepts IMAP too. The old server can stay switched off.

One list names every mailbox and the batch uploads each one to its account on your new server.
  1. Create the accounts. Create each of your users on the new Grommunio server with grommunio-admin user create and grommunio-admin passwd. Each mailbox needs its own account. The migrator asks for the server address and port.
  2. Copy the Gromox folder. Copy your /var/lib/gromox folder with rsync or a snapshot to a 64-bit Windows PC.
  3. Add the copy and the list. Start the migrator, select your copy and add a CSV mailbox list that names the users you want to move.
  4. Choose IMAP. Choose IMAP server, type the address and port of the new server and add the account of each mailbox. Begin with two mailboxes.
  5. Start the batch and read the log. Start the batch and select Resume if it stops. Open the log, then check three mailboxes on the new server against your copy. Change the MX record only after they match.

An IMAP upload moves mail folders only. Contacts and calendars leave the migrator as separate vCard and ICS files. You import them on the new server yourself. Change the MX record last and update SPF later, so that the new server may send mail for your domain.

Limitations: the trial moves 25 messages from each folder. Mail that arrives on the old server after you copy the folder is missing from the batch, so keep that server up for a few days after the MX change. The migrator needs .NET Framework 4.8 on Windows 11 or 10. I have timed no large batch, so test your own mailboxes first.

Move your Grommunio mail to a new server from Windows

Windows reads your Gromox copy and uploads each mailbox on your list to the new server over IMAP.

Download Free Trial Select a Licence - From $999

Two trial mailboxes on your new server show the folder tree before you plan the cutover.

What If Mail Is Missing on the New Grommunio Server?

1. The restore stops on versions

Do this: The guide wants the same MariaDB and Gromox versions on both servers. If yours differ, upload the mail over IMAP instead of restoring the backup.

2. The target refuses the upload

Do this: A refused upload usually means a wrong server address, port number or login for that mailbox. If those are right, enable IMAP logins on the new server.

3. Recent mail is missing

Do this: Newer mail on the live server is in no batch. Check what is missing against your copy.

A damaged exchange.sqlite3 file needs recovery before a move. See Univik's Grommunio mail recovery page.

Where Do the Facts in This Grommunio Server Migration Guide Come From?

I read Grommunio's backup and restore guide, its Operations page and the gromox-export man page on 15 November 2026. A claim that those pages do not support is not in this guide.

Univik's migration page supplies the product facts. Grommunio's commands can change with a release, so check each one against your own version.

Key Takeaways
  • A full restore needs MariaDB data, Gromox mailbox files and /etc settings from one backup on matching package versions.
  • Grommunio's guide gives no help for restores across major releases and no detailed steps for a new hostname.
  • GXMT files move single mailboxes. Create the user on the new server first and use -s on both sides.
  • An IMAP upload from a Gromox copy works when versions differ and brings mail only.
  • Contacts and calendars need their own vCard and ICS imports on the new server.

FAQ: Migrate Grommunio to New Server

How do I migrate Grommunio to new server?

Restore a full backup onto an appliance with the same package versions, move single mailboxes with GXMT files or upload mail over IMAP from a copy of your Gromox data.

Can I move Grommunio to another server by copying /var/lib/gromox?

Not on its own. The guide names three parts for a restore: MariaDB data, Gromox mailbox files and settings in /etc, all from one backup.

Do both Grommunio servers need the same versions?

For a full restore yes. Grommunio's guide wants matching MariaDB and Gromox versions and does not describe a restore across major releases.

Can I move one Grommunio mailbox to another server?

You can export it with gromox-exm2mt and import it with gromox-mt2exm into a user created on the new server. Test one mailbox first.

Can I migrate Grommunio mail over IMAP?

Yes. Univik Grommunio Migrator uploads mailboxes from a Gromox copy to an IMAP server and a new Grommunio server accepts IMAP.

What happens to contacts and calendars in an IMAP migration?

An IMAP server accepts mail folders. The migrator makes vCard files from your contacts and ICS files from your calendars. Each file then needs an import on the new server.

Can I migrate Grommunio while the old server is off?

Yes. A copied Gromox folder on Windows is the source, so the old server is not involved.

Can I test the Grommunio migration before I buy?

Yes. Each folder moves 25 messages in the trial, so check one mailbox first.

Leena Taylor Paul

Commands and limits on this page were read from Grommunio's documentation on November 15, 2026. Product facts come from Univik's migration page.

More Guides for Grommunio Mail

Choose the guide that matches the next step for your Grommunio data.

Grommunio guides 4