Download the binary for your platform:
For this guide we will proceed with Windows.
- Create a folder (for example: lobbipad-sync)
- Copy the binary (ad-sync.exe) to this directory
In the directory you just created, create a file called
This file is formatted in YAML syntax. It's possible to configure following options:
- ad_address: the address of your LDAP/AD server.
- ad_user: the user we can use to poll your LDAP Directory (read-only please).
- ad_password: the password to be used for this user (don't worry, we only use it to login locally).
- ad_group: this user-group will be synced to Lobbipad (create one in your AD instance or use an existing one).
- sync_api_token: Lobbipad API token for your account. (see 'Getting the API Token' for more information).
- ad_telephone_field: the name of the field where you save the mobile number of your hosts in AD, fe. 'cellphone' or 'telephone'. If this is not filled in we can't sync this information.
You can copy paste this in Notepad for example. Change the values to match your own AD/LDAP instance.
IMPORTANT: When saving this file using notepad, be sure to save as 'all files' and type 'sync-ad.yaml'.
Running the sync (manual)
To run the application, just double click 'ad-sync-win.exe'.
The sync application will output a
sync.log text file with some information of every run. This will allow you to see if the sync was successful, how many entries were found etc.
Check the lobbipad.com/settings/hosts to see if all your hosts were added.
Setup a recurring sync
Ensure the script runs every x time (fe. daily). Depending on your system use a task scheduler like CRON (Linux, macOS) or Task Scheduler (Windows).
Run x time a day using CRON/Scheduled task on the host machine. On Windows this is Task Scheduler.
Getting the API Token
- Go to Lobbipad
- Login using your credentials
- Click on 'Settings' -> 'API'
- After clicking you should see this:
- Choose a name for this API Key: for example: 'ad-sync' and click 'Create'.
- After clicking you should see a new entry.
- The value in 'Token' is the new API Key. Be sure to copy it and paste it in your configuration under 'sync_api_token'.