Supported editions for this feature: Business Standard and Business Plus; Enterprise; Education Standard and Education Plus; G Suite Business. Compare your edition
Before you install Google Workspace Migrate, make sure you meet the following system requirements.
Google Workspace Migrate is only available to customers using a supported edition (above). To find your edition, go to Which edition and payment plan do I have?
Google Workspace Migrate requirements
Additional hardware specifications might be required for larger-scale migrations.
Hardware requirements
- Supported runtime—Microsoft .NET 4.5 or later.
- Recommended operating system—Microsoft Windows Server 2016 or 2019.
- Supported browser—Chrome Browser.
- Platform server—One Windows Server with at least 4 cores, 16 GB of RAM, and 200 GB SSD.
- Database servers—2 Windows Servers, each with at least 16 cores, 64 GB of RAM, and a separate performance (SSD) persistent disk for the database data. For details, go to Configure disks to meet performance requirements.
For the separate disk:
- MySQL—We recommend approximately 1 TB per 100 million objects that you want to scan and migrate.
- CouchDB—We recommend approximately 1 TB per 40 million objects that you want to scan and migrate.
For more information about the databases, go to Install the databases.
- Node servers—At least one Windows server, each with at least 4 cores, 32 GB of RAM, and 200 GB SSD. For details, go to Consider how many node servers you need.
- Set all Windows machines (virtual or physical) to the high-performance power plan.
Network requirements
- The platform and all node servers must have network access to all data sources.
- Each server must connect to the other servers from within the same network.
- Servers in the network should reside in close physical proximity.
- To prevent an unintended restart of your servers during a migration, manage Windows updates outside of running migrations.
Port requirements
- Within your Google Workspace Migrate cluster, we recommend that you have:
- Outbound access to the internet to access software updates.
- Intra-cluster SMB access (TCP:445).
- Admin RDP access to all servers using TCP:3389.
For additional information, go to Securely connecting to VM instances.
- Make sure the following ports are open:
| Port | Platform & node servers use port to... |
|---|---|
| TCP:5131 | Communicate bidirectionally |
| TCP:3306 (default) | Access the MySQL server |
| TCP:5984 (default) | Access the CouchDB server |
| TCP:443 | Reach the target Google Workspace APIs |
|
Depending on where you're migrating from:
|
Reach the source APIs |
Google Workspace requirements
- A super administrator account on your target Google Workspace domain.
- Access to Google Cloud.
- A user account in your target Google Workspace domain for each person whose data you want to migrate. For information on how to create user accounts, go to Options for adding users.
- A user license for your users to start using Google products or services. For details, go to How licensing works.
- Google Workspace services (for example, Gmail, Google Calendar, and Google Drive) must be turned on in the Google Admin console on the target domain for users and the super administrator. If you're migrating from Google Workspace, turn on the services in the source domain as well. For details, go to Turn a service on or off for Google Workspace users.
Google Drive requirements
- Turn on the Drive and Docs service in the Admin console on the target Google domain for users (including the admin user). For details, go to Turn Drive on or off for users.
- Your admin account must have the Drive and Docs privileges. The super admin role comes with these privileges enabled by default. For more information, go to Administrator privilege definitions (Drive & Docs).
- Your target users (including the admin user) must be able to access Drive files using the Google Drive API. If you're migrating from Google Workspace, your source users (including the admin user) must also have access. For details, go to Allow third-party apps for Drive files.
- Make sure you're familiar with Shared drive limits. For more details on shared drives, go to Best practices for shared drives.
Need help?
If you need help with setting up Google Workspace Migrate or planning a migration, contact a Google Cloud partner.
Next step
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.