WebMail Pro ASP.NET documentation

Installation Instructions

Uploading the application

Unzip and upload the contents of WEBMAIL 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 WEBMAIL 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.

Creating and configuring virtual directory in IIS

  • in case of Remote Desktop access to a dedicated server:

    You should create IIS virtual directory for WebMail Pro. To do this:
    • open your IIS Manager, navigate YOUR_SERVER_NAME / Web Sites / Default Web Site in the left pane;
    • right-click Default Web Site and choose New / Virtual Directory from the context menu;
    • in Virtual Directory Creation Wizard, specify virtual directory name (e.g. webmail) and click Browse to find the folder where you placed WebMail Pro files and folders (e.g. C:\Inetpub\wwwroot\webmail);
    • in virtual directory settings, make sure application is created in Virtual Directory tab / Application settings / Application name. If you see that field grayed (i.e. non-editable) and the button at right is Create, you should press that button to create the application;
    • make sure ASP.NET 2.0 is selected in ASP.NET tab / ASP.NET version.
    • make sure Default.aspx is available in Documents tab / Enable default content page;
    • press OK.

      Now you can access WebMail Pro at (assuming you created the virtual directory with name webmail): http://your_server_name/webmail

      Admin Panel is available at: http://your_server_name/webmail/adminpanel

  • in case of uploading via FTP on a shared hosting:

    If your hosting control panel provides some kind of a virtual directory manager, i.e. a tool which shows you all folders and allows you to create and configure virtual directories, you should follow the same steps as in case of Remote Desktop or direct access.

Running web-based installation wizard

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

Configuring and troubleshooting 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 your login form, create/delete/edit domains and users, or otherwise configure WebMail Pro. Don't forget to delete install.htm file from the WebMail Pro ASP.NET scripts folder.

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

If you experience random logouts while using WebMail Pro, it may be a good idea to switch from default InProc session-state mode (storing session data in server memory) to StateServer mode (having those stored in a separate process). You can find more information on this at:

I'm getting "The previous session was terminated due to a timeout" message. Please help!

If you encounter issues when trying to access calendar, or you're getting database-related errors, please check the following page:

Troubleshooting issues with database