Migrate mail from Google Accounts or IMAP

G Suite Migration for Microsoft Exchange

After you create a new G Suite account, you can migrate email data from your old Google or IMAP-based email account using G Suite Migration for Microsoft® Exchange (GSMME). You can choose to migrate data using one of the following options:

  • Gmail—Uses IMAP to migrate data, but provides configuration presets to make migration simpler.
  • IMAP—Provides more options for greater control over the migration. You can migrate from nearly any type of RFC-compliant IMAP server.

To learn more about GSMME, see the GSMME Administration Guide, which includes detailed information about how GSMME works, getting started, and running your migration.

Step 1: Before you begin

Check the system requirements
Make sure you meet the system requirements for GSMME
Check whether you need to allow access for less secure apps
If you're migrating from a Google Account, you must give permission for less secure apps to access accounts. For more information, see Allow less secure apps to access accounts.

Note: Accounts that have 2-Step Verification don’t allow access to less secure apps. If you want to migrate mail for these accounts, 2-Step Verification must be disabled.

Disable folder-size limits and make labels available

Each user must individually disable folder-size limits and make the All Mail, Spam, and Trash labels available to IMAP.

  1. To disable folder-size limits, each user must:
    1. Open Gmail and click Settings Settings and then Settings.
    2. On the Forwarding and POP/IMAP tab, select Do not limit the number of messages in an IMAP folder and click Save Changes.
  2. To show All Mail, Spam, and Trash labels in IMAP, each user must:
    1. Open Gmail and click Settings Settings and then Settings.
    2. On the Labels tab, next to All Mail, Spam, and Trash, check the Show in IMAP box.
Create a CSV file of users
Create a CSV file of the user accounts that you are migrating. For more information, see Create a control CSV file for user accounts.

Step 2: Authorize GSMME

Before you can install GSMME, you must authorize the software for your domain. For details, see Authorize GSMME for your domain.

Step 3: Configure GSMME

Enter server details
  1. For IMAP Server Type, select the server type that applies to your migration. 
  2. In the Hostname/IP Address field, enter the address of your IMAP server. For instance, imap.gmail.com.
  3. Choose your IMAP Security preference.
  4. Enter your IMAP Port value. If you're using SSL, enter 993.
  5. If you're migrating from a Cyrus or Courier IMAP server, enter INBOX. Otherwise, leave the IMAP Path Prefix field blank.
  6. Click Next to enter domain and administrator information..
Enter domain and admin information
  1. In the G Suite domain name field, enter the new G Suite domain where the data will be delivered.
  2. In the Service account credentials field, enter the path to your credentials JSON file that was created as part of the authorization process.
  3. In the G Suite admin user field, enter the full email address of your G Suite domain super administrator.
  4. Click Next to enter data and migration settings.
Enter data and migration settings
  1. Select the settings that suit your migration needs. See step 4 in the GSMME Admin Guide for more information.
  2. Click Next.

    The Migration Settings screen appears, showing a summary of the configuration.

  3. Review and optionally make changes to the following settings:
    • Migrate all data—When checked, the utility will overwrite existing data during migration. When unchecked, duplicate messages will be skipped.
    • Save settings—When checked, the utility will retain the current configuration for future use.
    • Run Diagnostics—When checked, the utility will verify the configuration before running the migration.
    • Estimate—When checked, the utility will estimate the message count for the source users.
    • Migrate—When checked, the utility will perform the migration.  
  4. Click Next to begin the migration process.
Was this helpful?
How can we improve it?