If you've set up your organization to use Google Workspace, you can migrate users' email, calendar, and contact data from your Microsoft Exchange environment to Google Workspace using Google Workspace Migration for Microsoft Exchange (GWMME).
To learn more about GWMME, the GWMME Admin Guide includes detailed information on how GWMME works, getting started, and running your migration.
Step 1: Before you begin
- System requirements—Make sure you meet the GWMME system requirements.
- User accounts—Create a control CSV file of the user accounts you are migrating to make sure your legacy data correctly maps to your new Google Workspace user accounts. The format of the control CSV file depends on the system from which you are migrating. Learn more
- Calendar resources—If you are migrating calendar resources, you should also create a mapping CSV file. Learn more
Step 2: Authorize GWMME
Before you can install GWMME, you must authorize the software for your domain. For details, go to Authorize GWMME for your account.
Step 3: Download and install GWMME
- Download the MSI file from the GWMME download page.
- Open the installer and follow the instructions to install GWMME.
Step 4: Configure GWMME
Complete these steps in the GWMME tool.Step 1: Exchange server details
- Run GWMME: Click StartGoogle Workspace MigrationGoogle Workspace Migration for Microsoft Exchange.
- For Server Type, select Exchange.
- In the Hostname/IP Address field, specify your source domain name or the IP address of the email server from which you want to migrate data. For example: smtp.example.com or 198.102.434.8.
- In the Admin username field, specify the username for the Exchange administrator account you want to use to open your users' mail stores.
- Calendar resources: If you are migrating calendar resources, do the following:
- To avoid migration errors, use a separate Google Workspace admin account for each GWMME instance.
- Change the number of parallel migrations in GWMME from 25 (default) to 1 in Step 3.
For more information on migrating calendar resources, see the "Best practices" chapter in the GWMME Admin Guide.
- Click Next.
- In the Google Workspace domain name field, specify the new primary Google Workspace domain where the data will be migrated.
Note: The domain you specify in step 1 of the GWMME tool must be the primary Google Workspace target domain environment you're migrating users to. If you're migrating mail to a Google Workspace account with secondary domains, the target domain you choose might differ from the domain in the email addresses you’re migrating.
- In the Service account credentials file field, specify the path to the JSON credentials file created as part of the authorization process.
- In the Google Workspace admin user field, specify the full email address of your Google Workspace domain super administrator.
- Click Next to specify the migration settings.
- Select the checkbox for each type of data you want to migrate: email, calendar, contacts, or public folders.
- In the File of accounts to migrate field, specify the path to the CSV file of user accounts you are migrating.
- Click Next.
- Review the migration settings and optionally make changes.
- Select your migration actions:
- Migrate all data—When checked, the utility overwrites existing data during migration. When unchecked, duplicate messages are skipped.
- Save settings—When checked, the utility retains the current configuration for future use.
- Run Diagnostics—When checked, the utility verifies the configuration before running the migration.
- Estimate—When checked, the utility estimates the message count for the source users.
- Migrate—When checked, the utility performs the migration.
- Click Next.
- In the dialog box that appears, specify the username and password for the Exchange administrator account you are using to open your users' mail stores.
Tip: Selecting Remember my password will bypass this step in future migrations.
- Click Start to begin the migration process.
Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.