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:
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.
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
mkdir -p /opt/activeserver/data
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
Open main configuration file
config.php with a text editor:
and specify paths for data and logs subdirectories:
When user connects to ActiveServer via ActiveSync protocol, their client needs to know DAV and mailserver details. Those are configured in
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.
Specify hostname and port number for IMAP access.
(if not available in
aurora.config.php file, check
By default, ActiveServer requires IMAP server to have a valid SSL certificate. To skip SSL certificate check for IMAP access, set IMAP_OPTIONS to
It's assumed standard port 143 is used. If you wish to use SSL-enabled port 993, make sure to set IMAP_OPTIONS to
For both the options enabled, set IMAP_OPTIONS to
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:
However, it's still possible to use ActiveServer with default
https://domain.com/dav.php/ URL as follows:
- 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:
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
- This concludes configuring ActiveServer itself, but to make things work, you'll also need to reconfigure your webserver and optionally set up autodiscover.
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.
- 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.