WebMail Pro 7 documentation

Installing on Windows

Uploading the application

Unzip and upload the contents of web folder (the scripts, folders and other files of the application) from the installation package onto your web server. Let's assume you created a folder webmail in the root of your web space (web root) and placed the contents of the web folder there. This way, you'll be able to access the application through the web at the http://your_domain/webmail URL.

Examples (assuming you want to use webmail name for the target folder):

* in case of Remote Desktop access to a dedicated server, the web root usually looks like C:\Inetpub\wwwroot\. Thus, you should create C:\Inetpub\wwwroot\webmail folder and place the application files/folders there.

* in case of uploading via FTP on a shared hosting, the web root is usually something like /wwwroot and you should create and upload into /wwwroot/webmail folder.

Protecting your private data from non-authorized access (for IIS only)

This step is not necessary in case of Apache web server as the data folder is protected by its .htaccess file.

Because WebMail data folder may contain your messages and temporary files with your private data, it needs to be protected from direct web access. But it's placed in WebMail data folder by default. So, to secure your data folder, move it (from your WebMail folder you created one the 1st step) to a place inaccessible from web. This should prevent non-authorized access to your private data.

In case of Remote Desktop access to a dedicated server, it may be C:\Inetpub\webmail_data

In case of uploading via FTP on a shared hosting, it's usually /webmail_data

After that, you'd need to adjust the path to the data folder in inc_settings_path.php file.

Assigning owners/permissions on the filesystem

Skip "Assigning owners/permissions" step if all of the following is true:

* you only have FTP access to your server;

* you do not have a web control panel (like WHM or Plesk) at all or it does not allow setting permissions;

* you have no other options to set permissions.

If all of the above is true (usually, shared hosting with preconfigured permissions), the permissions should be OK but if they are not and the hosting provider does not allow you to set them, you will need to contact their support to do this for you.

Assigning permissions through Remote Desktop or direct access

The following steps allow you to assign necessary permissions:

* using Windows Explorer, navigate to the folder which contains the data folder;

* in the context menu, choose "Properties" of the data folder and "Security" tab;

* add Internet Guest Account (usually IUSR_...) into the list;

* tick "Allow full control" checkbox to grant permissions and press "OK".

Try using your WebMail after that. If assigning the permissions doesn't seem to have any effect, repeat the same steps, but instead of granting "Full Control" to Internet Guest Account (usually IUSR_...) account, grant the same permission to Everyone user. This is quite secure as your data folder is already protected from direct access from web in step 2.

Assigning permissions through WHM or other hosting control panel

If your hosting control panel provides some kind of a file manager, i.e. a tool which shows you all files and folders and allows you to set set permissions for files and folders, you should set the same permissions as in case of Remote Desktop or direct access.

Protecting data directory

All configuration files of the application are stored in data directory which shouldn't be accessible over the web, so it's important to protect data directory. The recommended approach is to move it outside of web directory, or at least rename it so the name can't be easily guessed.

To let WebMail know the new name and location of the data directory, create inc_settings_path.php file in root WebMail dir, or modify it if it's already there. It should have the following content:

$dataPath = '/new/location/of/data';

where $dataPath value contains filesystem path of data directory location, it can be either absolute or relative path.

Running web-based installation wizard

Open http://your_server_name/webmail/install/ page in your browser and follow the instructions.

Also, be sure to check DAV server configuration documentation page.

Configuring your installation

After completing the instructions of the installer, you'll be redirected into AdminPanel (http://your_server_name/webmail/adminpanel). There, you can then customize WebMail Pro settings, create/delete/edit domains and users, or otherwise configure WebMail Pro. Don't forget to delete install directory from the WebMail Pro folder.

If you skipped the installation wizard, you can log into AdminPanel using default credentials mailadm/12345 and configure the product from there.

You can fine-tune your product installation by modifying settings.xml file.

Now the installation is complete, WebMail Pro is ready to use. Start using it at http://your_server_name/webmail/index.php.

Again, make sure you protected data directory so that http://your_server_name/webmail/data/settings/settings.xml (and https) is not accessible. Otherwise, your system is at risk!

Optional features

Setting up filters, autoresponders, forwarding

Downloading all attachments as ZIP archive