<b>DISCLAIMER:</b> This is for Amahi 7 on [[Fedora_19|Fedora 14 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 />

* 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://www.godaddy.com GoDaddy], [http://www.hostgator.com 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, [http://www.no-ip.org no-ip.org], etc), you will have to [[Masquerade_email_address|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 [[Intro|HDA]].

1.8.7 05 ([[Fedora_19|Fedora 1419]]) released May 13January 1, 20112014

* Quota information present During the configuration, the ClamAV definitions download sometimes takes too long. It can cause the setup to fail, depending on availability of their server.** The proposed work around is to run the ClamAV virus definition update after setup is complete.** Comment out line 164 (<code>/usr/bin/freshclam -v</code>) in ''mail-setup.sh'' script. ** Run this separately after configuration is complete when you will see the database needs to be removed or hiddennotification ''You have 2 new messages.''

* Upgraded to Fedora 14* Command line installation replaced with 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 [[Amahi_7|Amahi 7]] on install* Packaged [http://www.amahi.org/apps/squirrelmail SquirrelMail[Fedora_19|Fedora 19]] separately, removing it from the core* Store system settings (host, user, and certificate information) in MySQL database* New logo and screen shot for application* Added Instructions to explain initial setup and Virtual User Management* Refined input form to detect HDA hostname and first user* Fixed Log display to not redirect when install finishes* Added initial Login Credentials to install log* Updated missing Postfix configuration entries32-bit binaries* Changed Welcome/SPAM Test mail to be sent by postmasterweb page background color* Included configuration information in install logRemove quota info from web pages* Added database front-end for virtual user management* Created separate install and help guidance* Enabled Enable port 587 for sending mail* Added user authentication to secure integrated database managerRemoved mail quota from Postfix configuration* Minor code updates to secure installFixed certificate errors when using spaces* Streamlined forms and minor code updatesuninstall script for better cleanup* Mailbox now created when new users addedAdded script to update mail certificate* Deleting users removes appropriate mailboxInserted additional logging messages

# Restart your [[Intro|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 Open terminal [[Open_Terminal_as_root|as '''root''' user]], and create a web app in Amahi named '''mailams'''(Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this capability.).# Open a terminal window, become Navigate to '''root''', and navigate to <u>/var/hda/web-apps/mail</u> ams''''' directory.# Download [httphttps://dl.getdropboxdropboxusercontent.com/u/1380867/mail-server-1.8.7.tar05.gz zip mail-server-1.8.7.tar05.gzzip] (sha1sum aba4ba3c164937c6724b844f1c3179c86f23f9424d5623d5d00a4d66512455deaec688fc49a34782) to this directory and extract it into <u>'''''html</u> ''''' directory of mail '''''ams''''' (archive [http://dl.getdropbox.com/u/1380867/FilesList.html contentfile list]).

# Need to make a directory called '''''elevated''''' in <u>mail</u>'''''ams'''''. Copy mail-setup.sh and del-maildir.sh to that location.

# Create the database and insert the data from the mail.sql file located in the <u>conf</u> '''''config''''' directory. # Navigate to <b><nowiki>http://mail ams</nowiki></b> in your favorite web browser and you should see the login page.# Enter credentials (admin/amahi) and choose Login to display the install page (See [[Amahi_Mail_System#Tips|Tips ]] for how to change the login info).# Complete all the required info. Ensure you do not uses spaces in any data fields (i.e. mycity, my_city, or my.city are acceptable). Once finished, select the click the '''NEXT''' button and the data will be added to the database.

{{Code|<pre>su -cd /var/hda/web-apps/mailamswget httphttps://dl.getdropboxdropboxusercontent.com/u/1380867/mail-server-1.8.7.tar05.gzzipmkdir -p elevated

tar -xzpf unzip ../mail-server-1.805.zipchmod 755 *.7shchown -R apache:users * .tar.gz/elevated

mysql -umail -pmail mail < confconfig/mail.sql}}</pre>

# Open a terminal window, become [[Open_Terminal_as_root|as '''root'''user]], and navigate to <u>'''''/var/hda/web-apps/mailams/html</u> ''''' directory.

# From the '''''html''''' directory, run the script. This may take a while to complete.# Close the terminal window and remove Remove the web app in Amahi named '''mailams'''(Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this capability.) and close the terminal window.

{{Code|<pre>su -cd /var/hda/web-apps/mailams/htmlchmod 755 mail-remove.sh

./mail-remove.sh}}</pre><br>

<u>FetchYahoo</u><br>

*# * Open the Login,-class.php file with your favorite editorin the '''''/var/hda/web-apps/ams/html''''' directory*# * On lines 29 and 32, change to whatever works for you*# * 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|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 values for Country, State, City, Organization, Organizational Unit, and Number of Days for the certificate to be valid.** Once complete, you can execute the script to update the mail server certificates. su - cd /var/hda/web-apps/ams/html ./mail-cert-update.sh * Move mailbox data files to share** <u>MUST</u> be accomplished prior to doing the install (Step #12).** Will ensure if you uninstall, mailbox data files will be preserved.** Create a new [[Storage_and_file_sharing#Step_2:_Create_Shares|share]] named <b>ams</b> in Amahi dashboard Shares tab.** Open terminal [[Open_Terminal_as_root|as '''root''' user]] and execute the following commands: cd /var/hda/web-apps/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/users.php; sed -i '12s|/home/vmail|/var/hda/files/ams|' html/config/authmysqlrc; ====Troubleshooting====* Should your mail server hang up and stop working, you can most likely fix it with the <b>mail-stop.sh</b> and <b>mail-start.sh</b> scripts included in the app. Open terminal [[Open_Terminal_as_root|as '''root''' user]] and do the following:<pre>cd /var/hda/web-apps/ams/html./mail-stop.sh./mail-start.sh</pre> * If you get the message " warning: SASL authentication failure: No worthy mechs found." [[Open_Terminal_as_root|open a terminal as '''root''']] and execute the following: yum install cyrus-sasl{,-plain}: Restart Postfix systemctl restart postfix<!--* Add '''NEW''' users to the foo.com domain (does not include any DNS MX records). Modify the '''mail''' database and substitute your information accordingly:

*# Run the command line below to set up the '''''/home/vmail/foo.com/user ''''' mail files:{{Code|mailx -s Welcome user@foo.com < /var/hda/web-apps/mailams/html/config/welcome.txt}}

*# Run the command line below to set up the '''''/home/vmail/bar.com/me ''''' mail files:{{Code|mailx -s Welcome me@bar.com < /var/hda/web-apps/mailams/html/config/welcome.txt}}

abuse@foo.com}}-->

*# To enable port 587, edit '''''/etc/postfix/master.cf ''''' and uncomment the line starting with "# submission"

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 to show it's working. Direct any questions or comments to <<u>support [at] https://forums.amahi [dot.org the forums] org</u>>.

<b>NOTE:</b> These scripts were adapted from the [http://www.howtoforge.com/virtual-users-and-domains-with-postfix-courier-mysql-and-squirrelmail-fedora-1418-x86_64 Virtual Users And Domains With Postfix, Courier, MySQL And SquirrelMail (Fedora 14 18 x86_64)] tutorial written by [http://twitter.com/falko Falko Timme].