WebMail Pro 8 documentation

Installing on Debian / Ubuntu Linux

Introduction

AfterLogic WebMail Pro 8 can be automatically installed and configured on Ubuntu Linux, Debian Linux or any compatible Linux distribution.

It was tested on: Ubuntu 16.04, Ubuntu 17.04, Ubuntu 17.10, Ubuntu 18.04, Ubuntu 18.10, Ubuntu 19.04, Debian 9. It should also work on Linux Mint as well as other compatible flavors of Linux, as long as those provide the following dependencies: Apache 2, PHP 7.*, MySQL 5+.

In case if any components are not detected on the system, they will be automatically deployed from OS repository as dependencies.

Configuring repository access

To have the product installed, add the following line to /etc/apt/sources.list file:

deb http://apt.afterlogic.com/stable /

All the commands mentioned below must be run with superuser privileges. If you’re logged in as regular user, use su command on Debian or sudo su on Ubuntu to get full privileges. In case of Ubuntu, you can add sudo in front of a single command to get superuser privileges temporarily.

Install public PGP key using the following command:

wget -qO - http://apt.afterlogic.com/afterlogic.asc | apt-key add -

Update APT cache with:

apt update

Installing the package

To install the product package, run the following command:

apt install afterlogic-pro

Once WebMail is installed, it can be accessed at http://yourdomain.com/webmail-pro/ address, or http://localhost/webmail-pro/ for local access.

To configure the installation, you can log in as superadmin user, default password is empty.

The product itself resides under /usr/share/afterlogic-pro directory.

Upgrading the product installation

The product is upgraded in the standard way using APT repository. If you wish to check whether there are updates for any of the packages you have installed, run the following:

apt update
apt upgrade

If new version is available, it will be installed, preserving the product configuration and any plugins you may have installed.

Troubleshooting

In v8.3.5, CSRF protection was substantially revised and may require web server reconfiguration. We're now shipping .htaccess file to ensure authentication headers are sent through, but if you're getting Error 500, that may mean you have mod_rewrite disabled. To correct that, run the following as super user:

a2enmod rewrite
service apache2 restart

And if you receive "Cookies need to be updated. To continue, please click here or reload this page." message, make sure .htaccess file is actually read by the web server. Read more on this at CSRF protection documentation page.

Uninstalling WebMail

To uninstall WebMail Pro 8 completely, run:

apt purge afterlogic-pro

Feedback

If you encounter any issues, feel free to post reports at the Aurora Issue tracker.