Install & set up the platform

On the Windows server for the platform:

1. Run GoogleWorkspaceMigrate_Platform_Installer as an administrator.
2. Select a language for the installer and click OK. 
3. Accept the license agreement and click Next.
4. Choose where to install the Google Workspace Migrate platform and click Next.
5. Choose a start menu folder and click Next.
6. Select your additional shortcut options and click Next.
7. Enter a port number or accept the default port 5131 and click Next.
8. Enter your Google OAuth Client ID and click Next.

   You created the ID when you set up the Google Cloud console. See Create the OAuth Web client ID.

9. Click Browse, select the location of the JSON file that contains your service account key, and click Next.

   You created the JSON file when you created the Google Workspace service account. If you lost the file or deleted the key in the Google Cloud console, you need to repeat the steps to create a new one. For details, see Create a service account for authentication. 

10. Enter the email address of a super administrator of your target Google Workspace domain (where you’re migrating to) and click Next.

    Use the same email address as you used to authorize the service account. For details, see Create a service account for authentication. 

11. Click Install.
12. After the installation, click Finish.

Note: Record the host name or internal IP address of this Windows server. You need it in a later step.

When you install from the command line, the installer automatically chooses these setup options:

• Google Workspace Migrate install location (C:\Program Files\Google Workspace Migrate)
• Start menu folder (Google Workspace Migrate)
• Desktop shortcut created for all users
• Google Workspace Migrate management app automatically opens when Windows starts

On the Windows server:

1. Run PowerShell as administrator.
2. To install Google Workspace Migrate, enter the following command and any additional parameters (details below):

   GoogleWorkspaceMigrate_Platform_Installer_version-number.exe /CLIENTID=client-ID /SERVICEACCOUNT=C:\path-to-service-account.json /ADMINEMAIL=admin-email

3. To start the Google Workspace Migrate platform service, enter the following command:

   Start-Service -Name AppBridge.Local.ServiceHost

4. Open the Google Workspace Migrate management app from the Start menu. Alternatively, let the app reopen automatically when you restart Windows.

Command-line parameters

Upgrading the platform

The CLIENTID, SERVICEACCOUNT, and ADMINEMAIL parameters aren't required for an upgrade unless you want to change these values.

Example:

GoogleWorkspaceMigrate_Platform_Installer_version-number.exe /SP- /VERYSILENT /SUPPRESSMSGBOXES /NORESTART

If you’re using a proxy server, on the server where you installed the platform:

We do not recommend using a self-signed certificate. 

On the server where you installed the platform:

1. Import a TLS private key into the Windows personal certificate store. Consult your Microsoft documentation for details on importing a TLS private key.
2. If the certificate was issued by a certificate authority (CA) that isn't trusted by the computer, add the CA certificate to the Trusted Root Certification Authorities store. Consult your Microsoft documentation for details on how to place the certificate into the store.
3. As an administrator, open a command prompt.
4. To find the certificate thumbprint, enter the following command:

   PowerShell -Command dir cert:\LocalMachine\My

5. From the list of certificates in the local machine's personal store, copy the thumbprint of the certificate that you want to use.
6. To configure the port, enter the following command:

   netsh http add sslcert ipport=0.0.0.0:platform-port-number certhash=certificate-thumbprint appid= {3e3783f6-b92c-4546-8dee-672bf5c665ef}