Difference between revisions of "Amahi Mail System"

From Amahi Wiki
Jump to: navigation, search
Line 2: Line 2:
  
 
<b>DISCLAIMER:</b> 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.
 
<b>DISCLAIMER:</b> 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.
 
  
 
==== Current Version ====
 
==== Current Version ====
 
1.6 released 3 Oct 09
 
1.6 released 3 Oct 09
 
  
 
==== Version Changes ====
 
==== Version Changes ====
Line 12: Line 10:
 
* Added option for secure (https) or unsecure (http) webmail access.
 
* Added option for secure (https) or unsecure (http) webmail access.
 
* Optimized script code.
 
* Optimized script code.
 
 
<u>1.6</u>
 
<u>1.6</u>
 
* Added update to yum.conf file to exclude postfix from updates.
 
* Added update to yum.conf file to exclude postfix from updates.
 
* Updated custom RPMs to latest version for Fedora 10.
 
* Updated custom RPMs to latest version for Fedora 10.
 
* Added automated cronjob removal for uninstall.
 
* Added automated cronjob removal for uninstall.
 
  
 
==== Script download links: ====
 
==== Script download links: ====
 
32-bit:  http://dl.getdropbox.com/u/1380867/32bit-virtual-mail-1.6.tar.gz<br />
 
32-bit:  http://dl.getdropbox.com/u/1380867/32bit-virtual-mail-1.6.tar.gz<br />
 
64-bit:  http://dl.getdropbox.com/u/1380867/64bit-virtual-mail-1.6.tar.gz<br />
 
64-bit:  http://dl.getdropbox.com/u/1380867/64bit-virtual-mail-1.6.tar.gz<br />
 
  
 
==== Future Plans ====
 
==== Future Plans ====
 
* Add additional Squirrelmail plugins.
 
* Add additional Squirrelmail plugins.
  
 
+
==== 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.   
 
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.   
  
Line 33: Line 28:
  
 
* 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.
 
* 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.
 
  
 
==== Tips ====
 
==== Tips ====
 
* To permanently change your hostname from '''localhost.localdomain''', see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article].
 
* To permanently change your hostname from '''localhost.localdomain''', see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article].
  
 
+
==== Install Guidance ====
 
Here's the sequence of events to get the virtual email server up and running:
 
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.
 
# Restart your HDA so it's fresh for the install.  This is not required, just a recommendation.
Line 52: Line 46:
 
# To uninstall, run the '''uninstall-virtual-mail-1.6.sh''' script.
 
# To uninstall, run the '''uninstall-virtual-mail-1.6.sh''' script.
  
 
+
==== 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 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.  
 
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 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.  
 
  
 
<b>NOTE:</b>  These scripts were adapted from a tutorial authored by Falko Timme at [http://howtoforge.net/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-10 http://howtoforge.net/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-10].
 
<b>NOTE:</b>  These scripts were adapted from a tutorial authored by Falko Timme at [http://howtoforge.net/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-10 http://howtoforge.net/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-10].

Revision as of 03:01, 4 October 2009


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.

Current Version

1.6 released 3 Oct 09

Version Changes

1.5

  • Added option for secure (https) or unsecure (http) webmail access.
  • Optimized script code.

1.6

  • 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.

Script download links:

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

Future Plans

  • Add additional Squirrelmail plugins.

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.

Tips

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

Install Guidance

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.6.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 or mail_user are acceptable)
  7. Once it completes, run the install-virtual-mail-1.6.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.6.sh script.

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 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.