Amahi Mail System

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.

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.

• To permanently change your hostname from localhost.localdomain, see this article.

Script download links:

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

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

1. Create a web app in Amahi named webmail.
2. Open a terminal window, become root, and navigate to /var/hda/web-apps/webmail directory.
3. Download the script file (ensure you pick the correct one for your system) to this directory and extract it into the html directory of webmail.
4. From the html directory, run the host-update-virtual-mail-1.2.sh script. This will check your hostname. If it is not correct, you will be given an opportunity to change it.
5. Once it completes, run the install-virtual-mail-1.2.sh script. The dependencies will be first and you must answer the prompt to continue.
6. Watch the script for errors. At 2 points, you will have to provide responses for the script to finish successfully.
7. At the first prompt for testing the pop3 server, just type quit.
8. The second prompt you need to type ehlo localhost, then if everything appears ok then type quit.
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.2.sh script.

You should now be in 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 as well within your network. Unfortunately, there is currently no front-end for administering accounts, so you will have to modify the database via phpMyAdmin or Adminer.

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