System requirements

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:
  • MySQL—1 TB per 100 million objects that you want to scan and migrate
  • CouchDB—1 TB per 40 million objects that you want to scan and migrate

    For details, go to Configure disks to meet performance requirements and Install the databases.

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

• 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.
• Ensure that your admin account has the Drive and Docs privileges. The super admin role comes with these privileges by default. For details, go to Administrator privilege definitions (Drive & Docs).
• Check that your target users (including the admin user) can 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.
• Review Drive folder limits.
• Review shared drive limits.

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