{{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 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.<br /><br />

The primary intent of * 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 Amahi Mail System is to domain name. This will allow you to pull all ISP email into send/receive mail as your serverhostname (i.e. myhda@home. Keep in mind this is still under developmentcom).

* It allows If 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 use the free ones (i.e. [http://wwwuser.godaddyyourhda.com GoDaddy], [http://www.hostgatorno-ip.com Host Gatororg no-ip.org], etc). With these services, there is typically what is called a MX record associated with the domain name. This you will allow you have to send/receive mail [[Masquerade_email_address|masquerade your email address]] as your hostname ISP (i.e. myhda@homeyourisp.com). This will ensure you can receive email replies from those you send from your [[Intro|HDA]].

* If you use the free ones ==== Current Version ====1.05 (i.e. user.yourhda.com, [http://www.no-ip.org no-ip.org[Fedora_19|Fedora 19]])released January 1, 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.2014

32-bit: http://dl.getdropbox.com/u/1380867/32bit-virtual-==== Future Enhancements ====* Expand instructions to include how to configure mail-1.2.tar.gz<br />clients64-bit: http://dl.getdropbox.com/u/1380867/64bit-virtual-* Incorporate a mail-1.2.tar.gz<br />backup mechanism* Streamline code and validate form fields* Move mailbox data files to share (See [[Amahi_Mail_System#Tips|Tips]] below)

# Create Restart your [[Intro|HDA]] so it's fresh for the install. This is not required, just a recommendation.# Open terminal [[Open_Terminal_as_root|as '''root''' user]], and create a web app in Amahi named '''webmailams'''(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/webmail</u> ams''''' directory.# Download the script file [https://dl.dropboxusercontent.com/u/1380867/mail-server-1.05.zip mail-server-1.05.zip] (ensure you pick the correct one for your systemsha1sum 4d5623d5d00a4d66512455deaec688fc49a34782) to this directory and extract it into the <u>'''''html<''''' directory of '''''ams''''' (archive [http://dl.getdropbox.com/u> /1380867/FilesList.html file list]).# Ensure you recursively change ownership of the files to apache:users.# Need to make a directory of webmailcalled '''''elevated''''' in '''''ams'''''. Copy mail-setup.sh and del-maildir.sh to that location.# Ensure mail-setup.sh and del-maildir.sh are executable.# From Create the database and insert the data from the mail.sql file located in the '''''config''''' directory. # Navigate to <b><nowiki>http://ams<u/nowiki>html</ub> directoryin 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. Once finished, run select the click the '''hostNEXT''' button and the data will be added to the database.# 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.# Use your favorite mail client, [http://www.amahi.org/apps/roundcube Roundcube], [http://www.amahi.org/apps/atmail AtMail], or [http://www.amahi.org/apps/squirrelmail SquirrelMail] to access your new mail account.# Use the built-in tool to manage Virtual User information in the database. [http://www.amahi.org/apps/dadabik DadaBIK], [http://www.amahi.org/apps/phpmyadmin phpMyAdmin], or [http://www.amahi.org/apps/adminer Adminer] can also be utilized. ===== Example Install Terminal Session =====<pre>su -cd /var/hda/web-apps/amswget https://dl.dropboxusercontent.com/u/1380867/mail-updateserver-virtual1.05.zipmkdir -p elevatedcd htmlunzip ../mail-server-1.205.zipchmod 755 *.shchown -R apache:users * ../elevatedcp mail-setup.sh ../elevatedcp del-maildir.sh ../elevatedhda-create-db-and-user mailmysql -umail -pmail mail < config/mail.sql</pre> ==== 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 database.# Ensure mail-remove.shis executable.# From the '''''html'''' ' directory, run the script. This will check your hostname. If it is not correct, you will be given an opportunity may take a while to change itcomplete.# Once it completes, run Remove the web app in Amahi named '''ams'''install(Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this capability.) and close the terminal window. ===== Example Uninstall Terminal Session =====<pre>su -cd /var/hda/web-apps/ams/htmlhda-create-db-and-virtualuser -d mail./mail-1remove.sh</pre><br> ==== Add-Ons ====<u>Mailman</u><br>You can now add the Mailman software to your Amahi Mail System. Follow the instructions at [http://wiki.amahi.org/index.php/Amahi_Mailman Amahi Mailman]. <u>FetchYahoo</u>Add capability to fetch Yahoo mail:* Download the latest [http://fetchyahoo.twizzler.2org/ FetchYahoo]* Install instructions included ==== Tips ====* To permanently change your hostname from '''localhost.shlocaldomain''' script, see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article]. * You can change the Login Credentials for the integrated database manager/web-based installer by doing the following:** Open the Login-class. The dependencies will be first php file in the '''''/var/hda/web-apps/ams/html''''' directory** On lines 29 and 32, change to whatever works for you** Save and now you must answer can log in using the new credentials * Change the prompt 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 continueupdate the mail certificates, use the mail-cert-update.sh script.# Watch ** Prior to executing the script for errors. At 2 points, you will have want to provide responses 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 finish successfullyupdate 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# At 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 first prompt for testing the pop3 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 serverhang up and stop working, just type 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 '''quitroot'''user]] and do the following:<pre>cd /var/hda/web-apps/ams/html./mail-stop.sh# The second prompt ./mail-start.sh</pre> * If you need to type get the message " warning: SASL authentication failure: No worthy mechs found." [[Open_Terminal_as_root|open a terminal as '''ehlo localhostroot''']] and execute the following: yum install cyrus-sasl{, then if everything appears ok then type -plain}: Restart Postfix systemctl restart postfix<!--* Add '''quitNEW'''users to the foo.com domain (does not include any DNS MX records). Modify the '''mail''' database and substitute your information accordingly:*# Once In the script is complete'''users''' table, note insert a new record with the following information...*#* ''user name '': <u>user@foo.com</u>*#* ''password'': choose 'ENCRYPT' for the function and enter the users password. (Alternatively, you can have the user enter their password)*#* ''quota'': do NOT edit this field (unless you know what you are doing)*# In the '''forwardings''' table, insert a new record for each forwarded email addresses to <u>user@foo.com</u>*# Navigate 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/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 - Creating a mail domain e.g. :*#* ''domain'' is: <u>bar.com</u>*#* ''server'' is: <u>foo.bar.com</u>*#* ''admin user'' is: <u>me@bar.com</u>*# In the mail mySQL database tables:*#* ''domain'': add <u>bar.com</u>http*#* ''transport'': add <u>bar.com</u>*#* ''user'': add <u>me@bar.com</webmailu>*#* ''forward'': add <u>postmaster@bar.com</u> , and enter your login credentials<u>abuse@bar.com</u> to <u>me@bar.com</u>*# 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. To accommodate this, port 587 is used by email clients for sending mail-1.2*# To enable port 587, edit '''''/etc/postfix/master.shcf''''' 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 in 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]].