Installation

  1. Download the package from here and extract it into the directory of your choice on the installation location.

    We'll assume you're installing ActiveServer on the same server as WebMail Pro / Aurora, into a parallel directory, for example:

    WebMail Pro / Aurora directory: /var/www/html/webmail
    ActiveServer directory: /var/www/html/activeserver

    However, you can install it onto an arbitrary location, on the same or a different server. Further on this documentation page, [activeserver] stands for ActiveServer installation path.

    Also, it's strongly advised to create a separate domain or subdomain pointing to ActiveServer installation (e.g. sync.domain.com).

  2. Create subdirectories for data and log files:

    mkdir [activeserver]/data
    mkdir [activeserver]/data/logs
  3. Open main configuration file config.php with a text editor:

    vi [activeserver]/config.php

    and specify paths for data and logs subdirectories:

    define('STATE_DIR', '[activeserver]/data/');
    define('LOGFILEDIR', '[activeserver]/data/logs/');
  4. When user connects to ActiveServer via ActiveSync protocol, their client needs to know DAV and mailserver details. Those are configured in aurora.config.php file:

    • CARDDAV_PROTOCOL, CARDDAV_SERVER, CARDDAV_PORT

      Specify protocol, hostname and port number for CardDAV access. You need to use the same hostname you've configured for DAV access in WebMail Pro / Aurora.

      If DAV is accessed over HTTPS, set CARDDAV_PROTOCOL to 'https' and CARDDAV_PORT to 443 - otherwise, set CARDDAV_PROTOCOL to 'http' and CARDDAV_PORT to 80.

    • CALDAV_PROTOCOL, CALDAV_SERVER, CALDAV_PORT

      Specify protocol, hostname and port number for CalDAV access. It's safe to have them identical to values for CardDAV access.

    • IMAP_SERVER, IMAP_PORT

      Specify hostname and port number for IMAP access.

    • IMAP_OPTIONS

      By default, ActiveServer requires IMAP server to have a valid SSL certificate. To skip SSL certificate check for IMAP access, set IMAP_OPTIONS to '/novalidate-cert'.

      It's assumed standard port 143 is used. If you wish to use SSL-enabled port 993, make sure to set IMAP_OPTIONS to '/ssl'.

      For both the options enabled, set IMAP_OPTIONS to '/ssl/novalidate-cert'.

    • AURORA_SMTP_SERVER, AURORA_SMTP_PORT

      Specify hostname and port number for SMTP access.

  5. This concludes configuring ActiveServer itself, but to make things work, you'll also need to reconfigure your webserver and optionally set up autodiscover.
  1. Another thing that needs to be done is enabling ActiveServer integration in your WebMail Pro / Aurora setup. Locate data/settings/modules/ActiveServer.config.json and set Disabled there to false. Once that's done, you should get ActiveSync tab in admin interface, with a setting for sync URL and few other options and informative fields.

  2. You'll get a trial license key when downloading the product, and a permanent key upon purchasing a license. In either case, you need to add the license key in WebMail Pro / Aurora admin area, Licensing screen. You need to append ActiveServer license key to WebMail Pro / Aurora one, without line breaks.
    Make sure you don't omit dash ("-") character the ActiveServer key starts with.