System requirements

Supported editions for this feature: Business Standard and Business Plus; Enterprise Standard and Enterprise Plus; 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 available only 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 Framework 4.5 or later (except for the CouchDB server, which requires Microsoft .NET Framework 3.5).
  • Recommended operating system—Microsoft Windows Server 2016 or 2019.
  • Supported browser—Chrome Browser.
  • Power plan—Set all Windows computers (virtual or physical) to the high-performance power plan.

Platform server

One Windows server with at least 4 cores, 16 GB of random-access memory (RAM), and 200 GB solid-state drive (SSD)

Database servers

  • 2 Windows servers, each with at least 16 cores, 64 GB of RAM
  • A separate performance (SSD) persistent disk for the database data. For the separate disk we recommend approximately:

Node servers

At least one Windows server with a minimum of 4 cores, 32 GB of RAM, and 200 GB SSD. For details, go to Consider how many node servers you need.

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 Server Message Block (SMB) access (TCP (Transmission Control Protocol) port 445)
  • Admin Remote Desktop Protocol (RDP) access to all servers using TCP port 3389

    For details, go to Securely connecting to VM instances.

Make sure the following ports are open:

  • TCP port 5131—Used to communicate bidirectionally
  • TCP port 3306 (default)—Used to access the MySQL server
  • TCP port 5984 (default)—Used to access the CouchDB server
  • TCP port 443—Used to reach the target Google Workspace APIs

To reach the source APIs, open the following ports:

  • Microsoft Exchange—Use Exchange Web Services on TCP port 443
  • Microsoft SharePoint or OneDrive—Use SharePoint client-side object model (CSOM) API on TCP port 443
  • File shares—Use TCP port 445 (additional network access might be required for older environments)
  • Box—Use Box API on TCP port 443
  • Google Workspace—Use Google APIs on TCP port 443

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
  • A user license for your users to start using Google products or services

    For details, go to Options for adding users and How licensing works.

In the Google Admin console for the target domain, turn on the Google Workspace services (for example, Gmail, Google Calendar, and Google Drive) 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 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