Amahi Mail System

	WARNING
	This should only be attempted by advanced users.

DISCLAIMER: This is for Fedora 14 only! Although tested, use at your own risk. I cannot guarantee that it will work for your system or not cause any serious problems.

	Work In Progress

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.8 (Fedora 14) released 16 Apr 11

Change Log

Upgraded to Fedora 14
Added a Web-based installer
Removed custom built Postfix (with Quota support) and Maildrop packages
Included Fedora Postfix and Maildrop packages
Removed DCC due to instability on install
Packed SquirrelMail separately
Store system settings (host, user, and certificate) in MySQL database.

Future Enhancements

New Logo for Mail Server App.
Add additional Squirrelmail plugins.
Include interface with fetchmail to automatically retrieve mail.

Script download links:

32-/64-bit: http://dl.getdropbox.com/u/1380867/mail-server.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.
Enable Advanced Settings in the Amahi Dashboard (Settings-->Settings)
Create a web app in Amahi named mail.
Open a terminal window, become root, and navigate to /var/hda/web-apps/mail directory.
Download the archive file to this directory and extract it into html directory of mail.
Ensure you change ownership of the files via chown -R apache:users /var/hda/web-apps/mail.
Need to make a directory called elevated in mail and copy mail-setup.sh to that location.
Ensure mail-setup.sh is executable. Do this via chmod 755 mail-setup.sh.
Navigate to http://mail in your favorite web browser and you should see the install page.
Complete all the required info. Ensure you do not uses spaces in any fields (i.e. mycity, my_city, or my.city are acceptable). Once finished, select the click the SUBMIT button and the data will be added to the database.
Next, a screen will appear with a INSTALL button. Click it to begin install. You will also notice a link that you can select to watch the install
Watch the log for errors.
Use your favorite mail app or SquirrelMail to access your new mail account.
Install DadaBIK to manage the database.

Example Terminal Session

bash code
`su - cd /var/hda/web-apps/mail wget http://dl.getdropbox.com/u/1380867/mail-server.tar.gz mkdir elevated cd html tar -xzpf ../mail-server.tar.gz cd .. cp html/mail-setup.sh elevated chown -R apache:users html elevated`

How to Uninstall

To remove the app, uninstall via the Amahi Dashboard like normal.

Mailman Add-On Option

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

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:

bash code
`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:

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

For every domain supported, the following either need to be added as users or forwarded. Without them a site MAY end up on various spam block lists:

 postmaster@foo.com
 abuse@foo.com

Some ISPs block port 25 for mail. Thus a remote user would be able to retrieve mail, but not send mail. To accommodate this, port 587 is used by email clients for sending mail.
- To enable port 587, edit /etc/postfix/master.cf and uncomment the line starting with "# submission"
- Reload postfix
Add capability to fetch Yahoo mail:

Download the latest FetchYahoo
Install instructions included

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 Virtual Users And Domains With Postfix, Courier, MySQL And SquirrelMail (Fedora 14 x86_64).

Amahi Wiki

Links

Personal tools

Navigation

Tools