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 directories for data and log files. You can create those as ActiveServer installation location subdirectories, but for security reasons, it's recommended to place them outside web root, for example /opt/activeserver/data/:

    mkdir -p /opt/activeserver/data
mkdir /opt/activeserver/data/logs

    You'll also need to make sure webserver is allowed to write into these directories, for example:

    chown www-data:www-data -R /opt/activeserver/data

  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', '/opt/activeserver/data/');
define('LOGFILEDIR', '/opt/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
      (if not available in aurora.config.php file, check backend/imap/config.php)

      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. For SSL-enabled servers, ssl:// needs to be prepended to hostname.

NB: By default, it's assumed that you have your webserver configured so that a dedicated subdomain or port is used for DAV access, e.g. in case of https://dav.domain.com/ DAV URL the configuration would look like:

define('CARDDAV_PROTOCOL', 'https');
define('CARDDAV_SERVER', 'dav.domain.com');
define('CARDDAV_PORT', 443);

However, it's still possible to use ActiveServer with default https://domain.com/dav.php/ URL as follows:

define('CARDDAV_PROTOCOL', 'https');
define('CARDDAV_SERVER', 'domain.com');
define('CARDDAV_PORT', '443/dav.php/');
  1. It is important to configure proper namespace and folders used by IMAP server. The configuration is performed in backend/imap/config.php file, look for the following line:
define('IMAP_FOLDER_CONFIGURED', true);

You'll need to determine the namespace your mailserver uses. One of the ways to do that is to log into one of the email accounts on that server with WebMail Pro / Aurora Corporate admin interface, select Inbox and other folders like Sent or Drafts, and check how the folder name is shown in browser's address bar, it may be one of the following:

  • INBOX, Sent, Drafts, etc.
  • INBOX, INBOX.Sent, INBOX.Drafts, etc.
  • rarely, it may be some other prefix value used.

Based on the results, set IMAP_FOLDER_PREFIX and other values in folders-related section of backend/imap/config.php file.

  1. 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.
© Copyright 2002-2024 Afterlogic Corp.