Install

Installation is pretty simple. Best and recommended way to run application is via docker compose. There are several docker-compose.yml templates for various scenarios. Anyway, there are some steps, that need to be done on GSuite site, before you start installation.

Start application

Make sure you have installed docker and docker compose.

1. Download docker-compose.yml for latest release.

2. Edit docker-compose.yml and set LDAP configuration based on your preferences in both services. Let's say we are setting up synchronization for G Suite domain company.com. We need to setup there properties:

   1. SLAPD_BIND_DN=cn=admin,dc=company,dc=com - username for LDAP
   2. SLAPD_BASE_DN=dc=company,dc=com - LDAP base DN
   3. SLAPD_PASSWORD=changeme - LDAP password
   4. GSUITE_DOMAIN=company.com - G Suite domain
   5. GSUITE_CLIENT_ID=*******.apps.googleusercontent.com - Google credentials client ID
   6. GSUITE_CLIENT_SECRET=****** - Google credentials secret

3. Run docker-compose up -d and follow logs with docker-compose logs -f

Configuration

1. Login to G Suite admin console and create identity.admins group. Then add your account to this group. Note: This account has to be also G Suite administrator.
2. Open URL http://localhost:8181 and sign in using account with G Suite admin access. Check if domain and username is correct and paste service account JSON obtained from Google cloud console then click Setup button.

Application test

Open in browser http://localhost:8181 and click Sign in.