Install on cPanel

Introduction

You can easily install WebMail Pro 8 on a cPanel server.

If you're a hosting provider and wish to offer WebMail Pro 8 to your clients (instead of the current webmail software, or in addition to it), follow the instructions below.

Note that current implementation of cPanel makes it impossible to use mobile sync when WebMail Pro 8 is installed via direct embedding. If, however, you don't need mobile sync, please feel free to proceed with the current method. For instance, mobile version will still work as it has nothing to do with mobile sync (which is actually CalDAV and CardDAV protocols support).

Installing through direct embedding

To begin, download the installer package from here. You can do that using the following command in terminal:

wget https://afterlogic.com/download/webmail-8-cpanel-installer.zip

Usually, it's downloaded to /root directory or your home dir on a cPanel server. In either case, extract it to the same location:

cd ~
unzip ./webmail-8-cpanel-installer.zip -d webmail-8-cpanel-installer

To perform the installation, root access is required. Open the installer directory, make sure that install script has sufficient execute permissions and run it:

cd ./webmail-8-cpanel-installer
chmod a+x ./installer
./installer -t pro -a install

The installer downloads WebMail Pro 8 package and performs the basic product configuration. The default installation path is /usr/local/cpanel/base/3rdparty/afterlogic.

It is assumed that this is blank installation of WebMail on particular server. In case if existing WebMail installation is found in this folder, installation will be aborted. For upgrading existing installation, a different command is required:

./installer -t pro -a upgrade

While upgrading the existing installation, only files are replaced while all data in the database are kept intact, the database structure is updated if necessary. Thus, you won't lose any existing data created by previous installations of WebMail Pro 8. And if you choose to remove WebMail installation, that is done with:

./installer -a remove

Troubleshooting the installation

If the following message is displayed when setting up the product:

WARNING! Database tables were not created. Try creating them from AdminPanel.

that means command-line version of PHP doesn't have PDO extension enabled, so the installer couldn't create the database tables. The issue isn't fatal though, you should still be able to create tables from Database settings screen of admin interface, see below on how to access it.

If you get error message of the following kind during the install:

Can't locate YAML/Syck.pm in @INC (@INC contains: /usr/local/cpanel /usr/local/lib64/perl5
/usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5
.) at /usr/local/cpanel/Cpanel/CPAN/YAML/Syck.pm line 8.
BEGIN failed--compilation aborted at /usr/local/cpanel/Cpanel/CPAN/YAML/Syck.pm line 8.
Compilation failed in require at /usr/local/cpanel/Cpanel/DataStore.pm line 19.
FAILED!

It means your cPanel installation is not configured for installing third-party modules yet. You can fix that by running the following commands:

perl -MCPAN -e shell
install YAML::Syck
exit

Then, unistall WebMail and try installing it again.

Accessing admin interface

Once the installation is complete, WebMail Pro 8 can be accessed at http://domain.com/webmail/. Here, domain.com stands for any domain name hosted by the server (IP address can be used instead). Any customer can access WebMail Pro 8 by adding /webmail/ to their domains. Once logged in, user will get full list of available webmail clients:

Note that you'll need email address created in cPanel to check mail, and you'll also need it to configure the product. To fine-tune WebMail Pro 8 installation, first log in webmail screen as shown above, then log out of user area of WebMail using Logout tool of webmail itself (rather than Logout tool of cPanel) and then log into admin interface. Default admin login is superadmin, default password is empty.

Once entered the admin interface, you can replace the trial key (generated by the installer) with your permanent one, change the default password for admin access, and configure the product in any other way you like. This is, however, optional, as the installer sets up the product to the fully operational state.

Alternative installation method

In some cases, using cPanel installer for WebMail Pro 8 might not be suitable: for example, if you don't have root access to the system, or you want to use native login screen of WebMail rather than one offered by cPanel.

The alternative solution is to install a regular package of WebMail Pro 8. This is done in exactly the same way you would do with any other PHP application: upload it to web directory of a particular domain, setup access permissions, configure the database, etc. Note that /webmail/ directory name is reserved by cPanel itself so you can't use that, but something like /email/, /mail/, /afterlogic/ etc. would work just fine.

And even though WebMail Pro 8 is installed under a specific domain in this scenario, it is still possible to access any email account hosted by that cPanel server.