Written by Paul Ogier on August 15, 2021

Installing GAMADV-XTD3 on Windows 10 or 11

This lesson is part of the "TAMING GAM - A practical guide to GAM and GAMADV-XTD3" course.

This lesson walks you through the set up of GAMADV-XTD3 on a Windows 10 Virtual Machine. You can also load it directly on your Windows 10 machine by following along with either the video below, or by following the images and steps detailed below.

If you are trying to install GAM on another operating system, please refer to these articles:

GAMADV-XTD3 on Ubuntu Linux

GAMADV-XTD3 on Google Cloud Shell

GAMADV-XTD3 on macOS

Are you however trying to just upgrade your installation of GAM?

Let's get started.

If you would like to try it yourself, you can start here.

Download And Install GAMADV-XTD3

Let's download the installation of GAMADV-XTD3 from the GitHub Releases page.

At the time of recording this video, we installed GAMADV-XTD3 6.06.09.

Then run through the installation of your GAMADV-XTD3. Open the file you downloaded and click next all the way through. Make sure that you make a note of the path that you are installing in.

Installation of GAMADV-XTD3

Then make sure that it has installed into the correct path in your C Drive.

GAM Installation directory

Set a configuration directory

When you install GAM, the default GAM configuration directory is C:\Users.gam.

To make it easier to work with multiple companies, you may want to change it to a non user-specific location. This example assumes that the GAM configuration directory will be C:\GAMConfig; If you've chosen another directory, substitute that value in the directions.

Make the C:\GAMConfig directory before completing the rest of the steps.

Set a working directory

Another tip, to make your processing of commands easier, is to create a GAM working directory.

In this folder you will execute commands from this folder. You should not use C:\GAMADV-XTD3 or C:\GAMConfig for this purpose.

Make the C:\GAMWork directory before completing the rest of the steps.

Create GAMConfig and GAMWork

Set system path and GAM configuration directory

Start Control Panel

Open Control Panel

Click System

Open System in Control Panel

Click Advanced system settings

Click Advanced System Settings

Click Environment Variables

Click Environment Variables…


Click Path under System variables and Click Edit.

Click Path under System variables


If C:\GAMADV-XTD3 is already on the Path, skip the next three steps
Click New
Enter C:\GAMADV-XTD3

Click New
Enter C:\GAMADV-XTD3


Click OK
Click New
Set Variable name: GAMCFGDIR
Set Variable value: C:\GAMConfig
Click OK

Set Variable value: C:\GAMConfig
Click OK


Click OK
Click OK
Exit Control Panel

Initialise GAMADV-XTD3

Open the command prompt and run this command to get into the GAMADV-XTD3 directory.

cd C:\GAMADV-XTD3

Then run this command to initialize GAM

gam config drive_dir C:\GAMWork verify
gam config drive_dir C:\GAMWork verify

Verify initialisation

Once the previous command has run, run this command to verify that the GAM installation has initialised.

dir %GAMCFGDIR%
dir %GAMCFGDIR%

Start Creating your GAM Project

If you still have the command prompt open, then run the below command to create the GAM Project.

gam create project

Then add your Google Admin or GCP Project Manager account to the GAM command

Then, once it runs, copy the link from the command prompt and paste it into your browser.

Then, once it runs, copy the link from the command prompt and paste it into your browser.

Choose Desktop APP

Choose Desktop APP

Name your OAuth Client ID

Name your OAuth Client ID

Now that your OAuth Client has been created, copy your Client ID and Client Secret into the command prompt.

image 18

Now we need to create the OAuth connection.

gam oauth create
The APIs with the stars next to them are going to be enabled.

The APIs with the stars next to them are going to be enabled. Make a selection of what APIs you want and then click "c" to continue. And enter your admin email.

Press allow to enable the APIs

Press allow to enable the APIs

Enable GAMADV-XTD3 service account access.

We now need to test that it has worked for a specific user.

gam user user@domain.com check serviceaccount
gam user user@domain.com check serviceaccount

Copy the long URL for the authorisation and paste it into your browser.

 Copy the long URL for the authorisation and paste it into your browser.

Then click authorise.

Then click authorise.

Now to test

Run the same command as before to test that it is authorised.

gam user user@domain.com check serviceaccount
Run the same command as before to test that it is authorised.

Now run this to test that you are connected to your domain.

gam info domain
Now run this to test that you are connected to your domain.

Congratulations, you are ready to run GAMADV-XTD3!

(Optional) Additional things you can run.

There are some other that are suggested that you can run.

Additional Options

gam config customer_id xxxx domain xxxx.com timezone local save verify

What is next?

So that was an quick lesson on how to get GAM set up for your domain on Windows 10. If you would like more info on how to use GAM and GAMADV-XTD3 for your Google Workspace, please check out this full course of over 9 hours here.

taers232c/GAMADV-XTD3: Command line tool to manage ... - GitHub
GAMADV-XTD3 is a free, open source command line tool for Google Workspace (formerly G Suite) Administrators to manage domain and user settings quickly and ...

Related Posts