System requirements

Before you install Google Cloud Directory Sync (GCDS), ensure you meet the following requirements.

Google Account

You need one of the following accounts:

  • A Google Account or Cloud Identity account 
  • A G Suite or Cloud Identity super administrator account

GCDS server

  • A server to run GCDS with one of the following operating systems:
    • Microsoft Windows (supported on Windows 7, 8, and 10, and Windows Server 2008, 2012, 2016, and 2019).
    • Linux—If you’re using a 32-bit version of GCDS on a 64-bit Linux system, a 32-bit libc (such as libc6-i386) must be installed.
  • If you’re using a Linux server, you need a GUI installed on the same server or access to another server with a GUI. (If you change servers, you need to reauthorize the configuration file. For details, see Use a configuration file with different machines or users.)
  • At least 5 GB of disk space for log files and data. If you’re running with the DEBUG or INFO level of logging, you might need more free space for additional logging data.
  • Free RAM—The amount required depends on the size of your organization:
    Number of users Recommended amount of free RAM
    Fewer than 10,000 1 GB
    10,000–200,000 2–4 GB
    200,000+ 8 GB

    You might need to increase the size of free RAM. For details, see What if I'm seeing memory-related errors?

LDAP server

  • All versions of LDAP are supported.
  • GCDS must be able to access the user information from the LDAP server. 
  • LDAP administrator access to your directory server.
  • Network access to your LDAP server. You don't need to run GCDS on your LDAP server.
  • Read permissions in LDAP server for the organizational units that you want to sync. 
  • An LDAP browser that can read and browse your LDAP directory server data.

Network requirements

  • Network access to your Google data through HTTPS directly or through a proxy server. Ensure ports 80 and 443 are open.
  • Access to Secure Sockets Layer (SSL) certificate authorities for your network. 
  • Network administrator privileges.
  • (Recommended) A network connection to your Google Account with no proxies or firewalls.
  • (Optional) Access to a mail server that is able to relay messages for GCDS notifications.

Level of effort and expertise

  • LDAP directory—Familiarity with your LDAP data. It’s also useful to be comfortable with LDAP query language.
  • Network expertise—Experience with your network and security settings for internal and outbound traffic. Able to set up mail servers for notification traffic.
  • Knowledge of your user base—Able to identify which LDAP entries represent current users and groups.
Was this helpful?
How can we improve it?