Amahi Mail System

NOTE: This should only be attempted by advanced users.

DISCLAIMER: Although this has been tested, use at your own risk. I cannot guarantee that it will work for your system or not cause any serious problems.

Purpose

The primary intent of the Amahi Mail System is to allow you to pull all ISP email into your server. Keep in mind this is still under development.

• It allows you to send/receive mail from your HDA. There are some quirks depending on if you have a registered domain with a paid service provider (i.e. GoDaddy, Host Gator). With these services, there is typically what is called a MX record associated with the domain name. This will allow you to send/receive mail as your hostname (i.e. myhda@home.com).

• If you use the free ones (i.e. user.yourhda.com, no-ip.org), you will have to masquerade your email address as your ISP (i.e. myhda@yourisp.com). This will ensure you can receive email replies from those you send from your HDA.

Current Version

1.75 (Fedora 12) released 9 Feb 10

Login Screen Shot

Change Log

• Added secure (https) webmail access.
• Added update to yum.conf file to exclude postfix from updates.
• Updated custom RPMs to latest version for Fedora 10.
• Added automated cronjob removal for uninstall.
• Optimized script code to eliminate redundancy.
• Corrected some minor bugs.
• Added mail quota exceeded notification.
• Customized login screen.
• Updated scripts and RPMs to Fedora 12.

Script download links:

32-bit: http://dl.getdropbox.com/u/1380867/32bit-virtual-mail-1.75.tar.gz
64-bit: http://dl.getdropbox.com/u/1380867/64bit-virtual-mail-1.75.tar.gz

How to Install

Here's the sequence of events to get the virtual email server up and running:

1. Restart your HDA so it's fresh for the install. This is not required, just a recommendation.
2. Create a web app in Amahi named webmail.
3. Open a terminal window, become root, and navigate to /var/hda/web-apps/webmail directory.
4. Download script file (pick the correct one for your system) to this directory and extract it into html directory of webmail.
5. From the html directory, run the host-update-virtual-mail-1.75.sh script. This will check your hostname. If it is not correct, you will be given an opportunity to change it.
6. Answer all the questions. The answers will further customize your install. Note: Mail user name and password must be one word only (i.e. mailuser, mail_user, or mail.user are acceptable)
7. Once it completes, run the install-virtual-mail-1.75.sh script. The dependencies will be installed first. Depending on your system, 68 is the typical amount for install on a new system.
8. Watch the script for errors. This may help narrow down the problem if you cannot log in.
9. Once the script is complete, note the user name and password.
10. Navigate to http://webmail and enter your login credentials.
11. To uninstall, run the uninstall-virtual-mail-1.75.sh script.

Tips

• To permanently change your hostname from localhost.localdomain, see this article.
• For https, most certificates are self-signed. You may need to follow the procedures listed here when accessing http://webmail.
• These are the steps needed to add NEW users to the foo.com domain (does not include any DNS MX records). Use phpMyAdmin to modify the mail database and substitute your information accordingly.
  • In the mail mySQL database:
    • In the users table:
      • Insert a new record with the following information...
        • user: user@foo.com
        • password: choose 'ENCRYPT' for the function and enter the users password. (Alternatively, you can have the user enter their password and click the "Go" button)
        • quota: do NOT edit this field (unless you know what you are doing)
        • Click the "Go" button
    • In the forwardings table:
      • Insert a new record for each forwarded email addresses to user@foo.com and click the "Go" button
  • Run the command line below to set up the /home/vmail/foo.com/user mail files:

mailx -s Welcome user@foo.com < /var/hda/web-apps/webmail/html/patch/welcome.txt

• These are the steps needed to add an additional mail domain (does not include any DNS MX records). Use phpMyAdmin to modify the mail database and substitute your information accordingly.
  • Creating a mail domain e.g. :
    • domain is: bar.com
    • server is: foo.bar.com
    • admin user is: me@bar.com
  • In the mail mySQL database tables:
    • domain: add bar.com
    • transport: add bar.com
    • user: add me@bar.com
    • forward: add postmaster@bar.com, and abuse@bar.com to me@bar.com
  • Run the command line below to set up the /home/vmail/bar.com/me mail files:

mailx -s Welcome me@bar.com < /var/hda/web-apps/webmail/html/patch/welcome.txt

Future Plans

• Add additional Squirrelmail plugins.
• Database front end to manage users, accounts, etc.
• Include interface with fetchmail to automatically retrieve mail.
• Change dependency on MYSQL root user for database creation.

Conclusion

You should now be able to log in to your account via webmail. There will be 2 messages, one is a welcome and the other is a SPAM test to show it's working. I forgot to mention that you can access the mail server from any email client (i.e. Thunderbird, MS Outlook, etc) as well within your network.

NOTE: These scripts were adapted from a tutorial authored by Falko Timme at http://www.howtoforge.com/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-12-x86_64.