System requirements

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

  1. Within your Google Workspace Migrate cluster, we recommend that you have:
    1. Outbound access to the internet to access software updates.
    2. Intra-cluster SMB access (TCP:445).
    3. Admin RDP access to all servers using TCP:3389.

      For additional information, go to Securely connecting to VM instances.

  2. 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:

  • Microsoft Exchange–Use Exchange Web Services on TCP:443
  • Microsoft SharePoint or OneDrive–Use SharePoint CSOM API on TCP:443
  • File shares–Use TCP:445

    Note: Additional network access might be required for older environments.

  • Box–Box API on TCP:443
  • Google Workspace–Google APIs on TCP:443
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

Need help?

If you need help with setting up Google Workspace Migrate or planning a migration, contact a Google Cloud partner.

Next step

Install & set up

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.

Clear search
Close search
Google apps
Main menu
Search Help Center