Carleton College
Carlpedia
Carlpedia

Imapsync

The one, the only, the Zimbra to Gmail Email Transfer Program (ZGET)

What do you want to know?

Where can I get it?

In the [Boring general information] section below, you'll see that we modified the open source code to make the transfer program work well between Zimbra and Gmail.

Note: The Windows transfer program works best with Windows 7. It does not work with Windows Vista.
Download the Windows transfer program.

*Warning!* The Mac transfer program will only work on Mac 10.6, and then not reliably. Use at your own risk, or run the program at a campus computer lab on the windows side.
Download the Mac transfer program.

How do I use it?

Step 1: Manually save large attachments

Because Gmail's attachment size limit is much lower than Zimbra's, it is impossible for emails that are too large to be transferred. You will have to download any attachments you would like to keep on your own:

  1. Sign in to Zimbra webmail.
  2. Just underneath the address bar, a text box should be displaying "in:inbox" (or something similar). Replace that with "larger: 24MB". This will display all messages with attachments that are too large for Gmail.
  3. If you only have a few, download each attachment, one by one. Done.
  4. If you have too many to review, create a new folder on the Zimbra server called "LargeAttachments."
  5. Select the attachments you care to keep (control-shift-A selects all) and move them to the "LargeAttachments" folder.
  6. Download the entire folder to your computer by browsing to the location https://mail.carleton.edu/home/~/LargeAttachments.zip

If you downloaded attachments piecemeal, you can open them directly. If you downloaded a LargeAttachments.zip archive, you will need to inject the contents of that archive into a program that can handle RFC822 and MIME. Most email programs can, but import can be obscure. Good luck!

Step 2: Use the Program

- Unzip the folder (right-click and choose 'Extract All' on Windows, double-click on Mac).
- Double click on "ZGET (Click Me!).hta"
- Enter your Zimbra and Gmail account information, then hit 'Transfer'. This is necessary for the program to be able to access your mail in order to transfer it from Zimbra to Gmail. You can call the ITS Help Desk at x5999 to confirm that the program you are running is correct and legitimate.
- On Mac, you may be prompted for your computer password to install files necessary to run the program. If trying to run on a Lab computer, run the Windows version instead.
- A command prompt (Windows) or Terminal (Mac) window will appear and, after a slight delay, the transfer process will begin. You can close the window to halt the transfer at any time.
- The process typically takes a few hours, depending on a number of factors (number of messages to transfer, size of messages, strength of internet connection, etc). Based on previous experience you can expect it to run for at least 2 hours, given ~8000 messages to transfer.
- When the program completes it will display statistics about the transfer and halt. Check your Gmail to ensure everything has transferred. If not, run ZGET again - No message will be duplicated by running ZGET more than once.

Calendars and Contacts

ZGET/Imapsync will usually copy your calendars and contacts, but not always in the right format. You might want to visit the Preferences tab in Zimbra webmail and visit Import/Export.

Boring general information

Imapsync is an IMAP to POP3 mail transfer program. You can check out the original source code here. It is maintained and updated by Gilles Lamiral, from France.

Imapsync can take in a label to apply to everything it transfers. For instance, with 'Zimbra' as the label and a folder named 'Comps' in your Carleton email, email in that folder will appear under the label 'Zimbra/Comps' in Gmail once it transfers. ZGET uses 'Zimbra' as the label by default to avoid confusion and email duplication.

ZGET is our homebrew attempt to make the program more accessible to the average user while still maintaining some of the functionality of imapsync. ZGET is available free of charge under the DWTFYW license.

What can imapsync do?

Imapsync can do quite a bit, which is why we wrote a script for it; there are too many options for the computer illiterate (and even some literates) to deal with. The settings used in the script use 17 options. There are more.

Options not used (but they could be):
-search (new! haven't checked it out yet) : selects messages with the powerful imap search command.
-min/max age : don't transfer any message newer/older than a specified number of days. (Windows ZGET can now make use of this option)
-exclude : skip folders that match a regular expression.
-folder(rec) : sync one folder (recursively)

Other email accounts

Imapsync should be able to transfer messages to any IMAP mail server, which includes the premium Yahoo mail (and probably quite a few others). Once I get the motivation and free time to look up Yahoo's info (server name, port, etc.), we could put that customization into ZGET.


On email providers other than GMail, disk quota may be an issue. Carleton's quota is the same as GMail's, about 10GB. Most other providers are not as generous. Before attempting to transfer your email to a non-GMail server, please check the size by hovering the mouse pointer over your name, in the upper right of the Zimbra webmail page, as shown at right.

Common issues

"cannot authenticate user" or something (more likely on Windows)

Some login info was entered incorrectly. Make it's the Carleton username (becerrac, NOT becerrac@carleton.edu), and Gmail address (helpre@gmail.com, NOT helpre) being entered. Also make sure caps lock is off and the passwords are being typed correctly.

"imapsync.exe is not recognized as an internal or external command" (Windows)

The folder may not have been actually unzipped.
On Windows, when you double-click a zipped file, it will NOT unzip it, but will display the contents anyway. This isn't workable; right-click the zipped folder and 'Extract all,' then find and use the unzipped folder. If 'Extract all' is not available, double-click the zipped folder and copy the contents somewhere outside of that (e.g. the Desktop).
This has always been the problem so far, but check to make sure that imapsync.exe and Transfer are in the same folder as well (if they're separated it won't run).

A folder won't transfer!

Folders with contacts or junk in their names are skipped by default (so you don't end up with a bunch of junk being transferred). If you can, rename the folder to something that doesn't contain contacts or junk.

Alternatively, Imapsync may have trouble if a folder is a subfolder of the "Inbox" folder in Zimbra. If subfolders of your inbox are not transferring or giving errors, try moving them out from under the inbox folder (click and drag the folder below trash, where they have a green outline, but no other folder is selected).

Label name too large

I don't have the exact wording for this error, but Gmail's label character limit is 225 characters, and if there are subfolders within subfolders... this limit may be hit . The offending folder should show up in the command line (since this error stops imapsync) - rename or move the folder.

Mac issues

When attempting to run the program, you may encounter an error message such as:

Can't locate IO/Socket/SSL.pm in @INC (@INC contains: /System/Library/Perl/5.8.6/darwin-thread-multi-2level /System/Library/Perl/5.8.6 /Library/Perl/5.8.6/darwin-thread-multi-2level /Library/Perl/5.8.6 /Library/Perl /Network/Library/Perl/5.8.6/darwin-thread-multi-2level /Network/Library/Perl/5.8.6 /Network/Library/Perl /System/Library/Perl/Extras/5.8.6/darwin-thread-multi-2level /System/Library/Perl/Extras/5.8.6 /Library/Perl/5.8.1 .).
BEGIN failed--compilation aborted.

This likely means one of the required libraries is missing. So far this has only happened on 10.4 machines. Try running the program on a 10.5 or higher version of Mac, or Windows, until a patch is made. (If you encounter this, email me (becerrac)! Info is good!)


Skip to end of metadata
Go to start of metadata