{{MessageBox|backgroundcolor = #FBB|image =Warning.png|heading =WARNING|message = This should only be attempted by advanced users.<br>It is still under development.}}<b>DISCLAIMER:</b> This is for Amahi 7 on [[Fedora_19|Fedora 19]] <u>ONLY</u>! Although tested, use at your own risk. I cannot guarantee that it will work for your system or not cause any serious problems.<br /><br /> ==== Purpose ====The primary intent of the [Categoryhttp:Apps//www.amahi.org/apps/amahi-mail-system Amahi Mail System] is to allow you to use your Home Digital Assistant ([[Intro|HDA]]) as a mail server.

<b>DISCLAIMER* It allows you to send/receive mail from your [[Intro|HDA]]. There are some quirks depending on if you have a registered domain with a paid service provider (i.e. [http:</b> Although this has been tested/www.godaddy.com GoDaddy], use at your own risk[http://www.hostgator.com Host Gator], etc). With these services, there is typically what is called a MX record associated with the domain name. I cannot guarantee that it This will work for allow you to send/receive mail as your system or not cause any serious problemshostname (i.e. myhda@home.com).

1.6 05 ([[Fedora_19|Fedora 19]]) released 3 Oct 09January 1, 2014

==== Version Changes Change Log ====<u>1.5</u>* Upgraded to [[Amahi_7|Amahi 7]] on [[Fedora_19|Fedora 19]]* Added option 32-bit binaries* Changed web page background color* Remove quota info from web pages* Enable port 587 for sending mail* Removed mail quota from Postfix configuration* Fixed certificate errors when using spaces* Streamlined uninstall script for secure (https) or unsecure (http) webmail access.better cleanup* Optimized Added script code.to update mail certificate* Inserted additional logging messages

<u>1.6</u>==== Future Enhancements ====* Added update Expand instructions to yum.conf file include how to exclude postfix from updates.configure mail clients* Updated custom RPMs to latest version for Fedora 10.Incorporate a mail backup mechanism* Streamline code and validate form fields* Added automated cronjob removal for uninstall.Move mailbox data files to share (See [[Amahi_Mail_System#Tips|Tips]] below)

==== Script download links: How to Install (Manual) ====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 />

==== Future Plans =Example Install Terminal Session =====<pre>su -cd /var/hda/web-apps/amswget https://dl.dropboxusercontent.com/u/1380867/mail-server-1.05.zipmkdir -p elevatedcd htmlunzip ../mail-server-1.05.zipchmod 755 *.shchown -R apache:users * Add additional Squirrelmail plugins../elevatedcp mail-setup.sh ../elevatedcp del-maildir.sh ../elevatedhda-create-db-and-user mailmysql -umail -pmail mail < config/mail.sql</pre>

The primary intent of ==== How to Uninstall (Manual) ====To uninstall, do the following:# Open terminal [[Open_Terminal_as_root|as '''root''' user]], and navigate to '''''/var/hda/web-apps/ams/html''''' directory.# Remove the Amahi Mail System database.# Ensure mail-remove.sh is executable.# From the '''''html''''' directory, run the script. This may take a while to allow you to pull all ISP email into your servercomplete. Keep # Remove the web app in mind Amahi named '''ams''' (Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this is still under developmentcapability.) and close the terminal window.

* It allows you to send===== Example Uninstall Terminal Session =====<pre>su -cd /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:var/hda/www.godaddy.com GoDaddy], [http:web-apps/ams/www.hostgator.com Host Gator]). With these services, there is typically what is called a MX record associated with the domain namehtmlhda-create-db-and-user -d mail. This will allow you to send/receive mail as your hostname (i-remove.e. myhda@home.com). sh</pre><br>

* If you use ==== Add-Ons ====<u>Mailman</u><br>You can now add the free ones (iMailman software to your Amahi Mail System.e. user.yourhda.com, Follow the instructions at [http://wwwwiki.no-ipamahi.org no-ip/index.orgphp/Amahi_Mailman Amahi Mailman]), 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.

Here's * Change the sender default email address format (i.e. root@hda.amahi.net) by following [[Masquerade_email_address|Masquerade email address]] tutorial. * Update mail certificate** Should you need to update the mail certificates, use the mail-cert-update.sh script.** Prior to executing the script, you will want to update the sequence values for Country, State, City, Organization, Organizational Unit, and Number of events Days for the certificate to get be valid.** Once complete, you can execute the script to update the virtual email mail server up and running:certificates. su - cd /var/hda/web-apps/ams/html ./mail-cert-update.sh * Move mailbox data files to share# Restart your HDA so it's fresh for ** <u>MUST</u> be accomplished prior to doing the install(Step #12). This is not required** Will ensure if you uninstall, just a recommendationmailbox data files will be preserved.# ** Create a web app new [[Storage_and_file_sharing#Step_2:_Create_Shares|share]] named <b>ams</b> in Amahi named '''webmail'''dashboard Shares tab.# ** Open a terminal window, become [[Open_Terminal_as_root|as '''root''', user]] and navigate to <u>execute the following commands: cd /var/hda/web-apps/webmail<ams sed -i '57s|/home/vmail|/var/hda/files/ams|' html/mail-setup.sh; sed -i '65s|/home/vmail|/var/hda/files/ams|' html/mail-setup.sh; sed -i '74s|/home/vmail|/var/hda/files/ams|' html/u> directoryusers.php; sed -i '12s|/home/vmail|/var/hda/files/ams|' html/config/authmysqlrc;# Download script file (pick the correct one for ====Troubleshooting====* Should your system) to this directory mail server hang up and extract stop working, you can most likely fix it into with the <ub>mail-stop.sh</b> and <b>htmlmail-start.sh</ub> directory of webmailscripts included in the app. Open terminal [[Open_Terminal_as_root|as '''root''' user]] and do the following:# From the <upre>cd /var/hda/web-apps/ams/html./mail-stop.sh./mail-start.sh</upre> directory, run  * If you get the message " warning: SASL authentication failure: No worthy mechs found." [[Open_Terminal_as_root|open a terminal as '''hostroot''']] and execute the following: yum install cyrus-updatesasl{,-virtualplain}: Restart Postfix systemctl restart postfix<!-mail-1* Add '''NEW''' users to the foo.6com domain (does not include any DNS MX records).sh Modify the '''mail''' database and substitute your information accordingly:*# In the '''users''' scripttable, insert a new record with the following information. This will check your hostname. If it is not correct, you will be given an opportunity to change it.*# Answer all the questions. * ''user'': The answers will further customize your install<u>user@foo. com</u>*#* ''password''Note:choose 'ENCRYPT'' Mail for the function and enter the users password. (Alternatively, you can have the user name and enter their password must be one word only )*#* ''quota'': do NOT edit this field (i.e. mailuser or mail_user unless you know what you are acceptabledoing)*# Once it completesIn the '''forwardings''' table, run insert a new record for each forwarded email addresses to <u>user@foo.com</u>*# Run the command line below to set up the '''install''/home/vmail/foo.com/user''''' mail files:{{Code|mailx -virtuals Welcome user@foo.com < /var/hda/web-apps/ams/html/config/welcome.txt}}* Add an additional mail domain (does not include any DNS MX records). Modify the ''mail'' database and substitute your information accordingly:*# Scenario -1Creating a mail domain e.g.6:*#* ''domain'' is: <u>bar.shcom</u>*#* ''server'' scriptis: <u>foo. The dependencies will be installed firstbar. Depending on your system, 68 com</u>*#* ''admin user'' is the typical amount for install on a new system: <u>me@bar.com</u>*# Watch In the script for errorsmail mySQL database tables:*#* ''domain'': add <u>bar. com</u>*#* ''transport'': This may help narrow down the problem if you cannot log inadd <u>bar.com</u>*# Once the script is complete, note the * ''user name and password'': add <u>me@bar.com</u>*# Navigate to * ''forward'': add <u>http:postmaster@bar.com</u>, and <u>abuse@bar.com</webmailu> to <u>me@bar.com</u> and enter your login credentials.*# To uninstall, run Run the command line below to set up the '''uninstall''/home/vmail/bar.com/me''''' mail files:{{Code|mailx -s Welcome me@bar.com < /var/hda/web-apps/ams/html/config/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:{{Text|Text=postmaster@foo.comabuse@foo.com}}--><!-virtual-* Some ISPs block port 25 for mail. Thus a remote user would be able to retrieve mail, but not send mail-1.6 To accommodate this, port 587 is used by email clients for sending mail.sh*# To enable port 587, edit '''''/etc/postfix/master.cf''''' scriptand uncomment the line starting with "# submission"*# Reload postfix --> ==== 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 [https://forums.amahi.org the forums].

You should now be able to log in to your account via webmail. There will be 2 messages, one is a welcome and <b>NOTE:</b> These scripts were adapted from the other is a SPAM test to show it's working[http://www. I forgot to mention that you can access the mail server from any email client as well within your networkhowtoforge. Unfortunatelycom/virtual-users-and-domains-with-postfix-courier-mysql-and-squirrelmail-fedora-18-x86_64 Virtual Users And Domains With Postfix, there is currently no front-end for administering accountsCourier, so you will have to modify the database via phpMyAdmin or AdminerMySQL And SquirrelMail (Fedora 18 x86_64)] tutorial written by [http://twitter.com/falko Falko Timme].

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