Amahi Mail System

2010-03-18T01:47:02Z

Nemolomen: Reformatted and added information regarding adding new users, passwords and forwards

[[Category:Apps]]

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. [http://www.godaddy.com GoDaddy], [http://www.hostgator.com 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, [http://www.no-ip.org 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

[http://wiki.amahi.org/images/1/1c/Amahi-Mail-System.PNG 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:
# Restart your HDA so it's fresh for the install. This is not required, just a recommendation.
# Create a web app in Amahi named '''webmail'''.
# Open a terminal window, become '''root''', and navigate to /var/hda/web-apps/webmail directory.
# Download script file (pick the correct one for your system) to this directory and extract it into html directory of webmail.
# 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.
# 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)
# 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.
# Watch the script for errors. This may help narrow down the problem if you cannot log in.
# Once the script is complete, note the user name and password.
# Navigate to http://webmail and enter your login credentials.
# To uninstall, run the '''uninstall-virtual-mail-1.75.sh''' script.

==== Tips ====
* To permanently change your hostname from '''localhost.localdomain''', see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article].
* For https, most certificates are self-signed. You may need to follow the procedures listed [[Web_Browser_Tips|here]] when accessing [http://webmail http://webmail].
* These are the steps needed to add '''NEW''' users to the foo.com domain (does not include any DNS MX records). Use [http://www.amahi.org/apps/phpmyadmin 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 [http://www.amahi.org/apps/phpmyadmin 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 [http://squirrelmail.org/plugins.php 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 http://www.howtoforge.com/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-12-x86_64].

Amahi Wiki - User contributions [en]

Amahi Mail System