Installing the Directory Agent

After you decide to use the Directory Agent instead of the cloud-based connector to synchronize your Active Directory data with, the first step is to install the Directory Agent on the server, or a server with access to your Active Directory data. This topic describes how to install the Directory Agent as a Windows Service.

When the Directory Agent is installed and configured, the agent pushes Active Directory data from your Intranet to the Messaging Platform, based on the configuration settings for the connection, exclusions, users, distribution lists, organizational units such as groups, and at the time and interval specified on the synchronization schedule.

To install the Directory Agent, you must have administrative rights on the server with access to your Active Directory data. In addition, after you install the Directory Agent, you must have Enterprise Admin Console access and privileges to access the configuration interface for the Directory Agent.

Hardware and Software Requirements

This section describes the operating system requirements, as well as server hardware requirements to run the Directory Agent.

Software Requirements

The following Microsoft Windows operating system platforms are supported. If your operating system is not listed, contact Support for more information.

  • Windows Server 2012 Foundation
  • Windows 10 Home
  • Windows 10 Professional
  • Windows 10 Enterprise
  • Windows 8.1 
  • Windows 8.1 Pro 
  • Windows 8.1 Enterprise 
  • Windows 8 
  • Windows 8 Pro 
  • Windows 8 Enterprise 

Hardware Requirements

The following tables lists the minimum hardware component requirements for Directory Agent.



Memory (RAM)

1 GB for Directory Agent

Available storage space

250 MB

Downloading the Directory Agent

You need to download the Directory Agent installer, and then run the installer program on the server with access to your Active Directory data.

To download the Directory Agent

  1. In the Enterprise Admin Console, in the Enrollment module, on the Directory Sync page, click Directory Agent in the Current Settings section. The Directory Agent section is displayed.
  2. Click Download.

A file named KoreDirectoryAgent< version >.msi is downloaded to your default download directory for the browser.

Copy or move the file to the root directory of your windows installation for your server, for example, C:/windows. Run the installer file using an Admin user for the server, or using the Run As Administrator property setting.

After installation, the KoreADagent service is installed and configured to run automatically on system start. A shortcut to run the configuration for Directory Agent is installed on your Windows Desktop, and in the Directory Agent folder on the Start menu.

Next Steps

With the agent installed, you are ready to configure your connection settings to, users and groups of users to sync, and the frequency of synchronizations. For more information, see Configuring Active Directory Sync.