Custom login page for Webmail

Article updated on 22 May, 2008

How to create custom login pages for each domain hosted by AXIGEN based on the hostname used to access the Webmail interface.

To enable differentiated Webmail login screens for each of your domains you should have the proper hostnames pointing to the machine running AXIGEN Mail Server. These hostnames should be associated with the domains for which you want customized Webmail login page.

Example:
Domains example1.tld and example2.tld are hosted by AXIGEN. Hostnames mail.example1.tld and mail.example2.tld need to point to the machine running AXIGEN Mail Server, in your DNS configuration settings.

In order to configure AXIGEN to use custom HSP login pages for one domain, from Webadmin interface go to Domains & Accounts menu, Manage Domains menu, click Edit on the desired domain to enter the Domain Configuration context.
In the General tab you will find the host headers field under "Display domain's specific login page for requests made with the following host headers" text. Write the desired hostname in the host headers field, click Add and Save Configuration to make changes permanent.

Examples:
1. For domain example1.tld you can write mail.example1.tld in the host header field and click Add. After the addition of the mail.example.tld host header, the HSP and CSS files mentioned below will be used as login page for Webmail interface, when accessed with hostname mail.example1.tld:
axigen/webmail/login_example1.tld.hsp
axigen/webmail/login_example1.tld.css

2. For a second domain example2.tld you can write mail.example2.tld in the host header field and click Add. After the addition of the mail.example2.tld host header the HSP and CSS files mentioned below will be used as login page for Webmail  inteface, when accessed with hostname mail.example2.tld.
axigen/webmail/login_example2.tld.hsp
axigen/webmail/login_example2.tld.css

NOTE:
The HSP and CSS files mentioned above will not be automatically created. You need to create these files in the axigen/webmail path and reload the AXIGEN service in order for the files to be read. Also note that after each change you make in these files, a reload action of the AXIGEN service may be required for the changes to take effect.

In the /var/opt/axigen/webmail/ path you can find some HSP pages with their respective CSS files that can be used as examples to create your own Webmail interface login screen. The files are:
axigen/webmail/login_standard.hsp
axigen/webmail/login_standard.css
(login_standard.hsp and login_standard.css is used by default as login page)

axigen/webmail/login_axigen.hsp
axigen/webmail/login_axigen.css

axigen/webmail/login_clearlook.hsp
axigen/webmail/login_clearlook.css

NOTE:
The path to the axigen directory is related to the OS distribution used on the machine running AXIGEN Mail Server. For Linux and UNIX (Solaris) distributions the path is /var/opt/axigen and for BSD distributions the path is /var/axigen

Releases: Mail Server 5.0.X, Mail Server 6.0.X, Mail Server 6.1.X
OS: Linux, FreeBSD, OpenBSD, NetBSD, Solaris
Distros: RPM based distros, RPM based distros with gcc3, RPM based distros with gcc4, Slackware, Debian, Ubuntu, Gentoo, FreeBSD 5.4, NetBSD 3.0, OpenBSD 3.8, OpenBSD 3.9, Solaris 10 x86, FreeBSD 6.1, Mandriva Linux, DEB based distros with gcc4, Yellow Dog, Solaris 10 SPARC, Debian 3.1, FreeBSD 6.x, OpenBSD 4.1, Fedora PPC, OpenBSD 4.2