Amahi Mail System

	WARNING
	This should only be attempted by advanced users. It is still under development.

DISCLAIMER: This is for Fedora 19 ONLY! Although 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 use your Home Digital Assistant (HDA) as a mail server.

• 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, etc). 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, etc), 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.03 (Fedora 19) released December 30, 2013

Known Issues

• Change the 12 to 16 in line 156 of mail-setup.sh.
• Certificate not generated if spaces used in credentials. Until resolved, do not use spaces in Country, State, City, Organization, or Unit.

Change Log

• Upgraded to Fedora 19
• Added 32-bit binaries
• Changed web page background color
• Remove quota info from web pages
• Enable port 587 for sending mail

Future Enhancements

• Expand instructions to include how to configure mail clients
• Incorporate a mail backup mechanism
• Streamline code and validate form fields

How to Install/Uninstall (Automated)

• Special access must be requested to install Amahi Mail System.
• Once granted, install/uninstall via the Applications tab in the Amahi Dashboard.

How to Install (Manual)

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. Open a terminal as root, and create a web app in Amahi named ams (see Create Manual Web App in Amahi 7).
3. Navigate to /var/hda/web-apps/ams directory.
4. Download mail-server-1.02.zip (sha1sum c528405143e26eb2f692b372767084041bfc7093) to this directory and extract it into html directory of ams (archive content).
5. Ensure you recursively change ownership of the files to apache:users.
6. Need to make a directory called elevated in ams. Copy mail-setup.sh and del-maildir.sh to that location.
7. Ensure mail-setup.sh and del-maildir.sh are executable.
8. Create the database and insert the data from the mail.sql file located in the config directory.
9. Navigate to http://ams in your favorite web browser and you should see the login page.
10. Enter credentials (admin/amahi) and choose Login to display the install page (See Tips for how to change the login info).
11. Complete all the required info. Once finished, select the click the NEXT button and the data will be added to the database.
12. Next, a screen will appear with a INSTALL button, click it to begin. You will also notice a log link so you can monitor the install.
13. Use your favorite mail client, Roundcube, AtMail, or SquirrelMail to access your new mail account.
14. Use the built-in tool to manage Virtual User information in the database. DadaBIK, phpMyAdmin, or Adminer can also be utilized.

Example Install Terminal Session

su -
cd /var/hda/web-apps/ams
wget https://dl.dropboxusercontent.com/u/1380867/mail-server-1.02.zip
mkdir elevated
cd html
unzip ../mail-server-1.02.zip
cp mail-setup.sh ../elevated
cp del-maildir.sh ../elevated
chmod 755 ../elevated/mail-setup.sh ../elevated/del-maildir.sh
chown -R apache:users ../html ../elevated
hda-create-db-and-user mail
mysql -umail -pmail mail < config/mail.sql

How to Uninstall (Manual)

To uninstall, do the following:

1. Open a terminal as root, and navigate to /var/hda/web-apps/ams/html directory.
2. Remove the database.
3. Ensure mail-remove.sh is executable.
4. From the html directory, run the script. This may take a while to complete.
5. Remove the web app in Amahi named ams (see Create Manual Web App in Amahi 7) and close the terminal window.

Example Uninstall Terminal Session

su -
cd /var/hda/web-apps/ams/html
chmod 755 mail-remove.sh
hda-create-db-and-user -d mail
./mail-remove.sh

Add-Ons

Mailman
You can now add the Mailman software to your Amahi Mail System. Follow the instructions at Amahi Mailman.

FetchYahoo Add capability to fetch Yahoo mail:

• Download the latest FetchYahoo
• Install instructions included

Tips

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

• Should your mail server hang up and stop working, you can most likely fix it with the mail-stop.sh and mail-start.sh scripts included in the app. Open a terminal as root and do the following:

cd /var/hda/web-apps/ams/html
chmod 755 mail-start.sh mail.stop.sh
./mail-stop.sh
./mail-start.sh

• You can change the Login Credentials for the integrated database manager/web-based installer by doing the following:
  1. Open the Login-class.php file in the /var/hda/web-apps/ams/html directory
  2. On lines 29 and 32, change to whatever works for you
  3. Save and now you can log in using the new credentials

• Change the sender default email address format (i.e. root@hda.amahi.net) by following Masquerade email address tutorial.

Conclusion

You should now be able to log in to your account. There will be 2 messages, one is a welcome and the other is a SPAM test. Direct any questions or comments to <support [at] amahi [dot] org>.

NOTE: These scripts were adapted from the Virtual Users And Domains With Postfix, Courier, MySQL And SquirrelMail (Fedora 18 x86_64) tutorial written by Falko Timme.