{{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 Amahi Mail System is still under development. * 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). These With these services, there is typically what is called a MX record associated with the domain name. This will be elaborated on more at a later timeallow you to send/receive mail as your hostname (i.e. myhda@home.com).

32-bit: ==== Known Issues ====* During the configuration, the ClamAV definitions download sometimes takes too long. http://dlIt can cause the setup to fail, depending on availability of their server.getdropbox** The proposed work around is to run the ClamAV virus definition update after setup is complete.com** Comment out line 164 (<code>/uusr/1380867bin/32bit-virtualfreshclam -mail-1.2.tar.gzv<br /code>64) in ''mail-bit: http://dlsetup.getdropbox.com/u/1380867/64bit-virtual-mail-1sh'' script. ** Run this separately after configuration is complete when you will see the notification ''You have 2new messages.tar.gz<br />''

# 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 '''NEXT''' button and the data will be added to the database.# Next, a screen will appear with a '''hostINSTALL''' 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-updatein 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-server-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 may take a while to complete.# Remove the web app in Amahi named '''ams''' (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-user -d mail./mail-remove.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.org/ FetchYahoo]* Install instructions included ==== Tips ====* To permanently change your hostnamefrom '''localhost.localdomain''', 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.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 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. If it is not correct * 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 given an opportunity valid.** Once complete, you can execute the script to change itupdate 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 # Once it completes12).** Will ensure if you uninstall, run 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|'installhtml/mail-setup.sh; sed -virtuali '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-1stop.2sh</b> and <b>mail-start.sh</b> scripts included in the app. Open terminal [[Open_Terminal_as_root|as '''root''' scriptuser]] 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. The dependencies will be first " [[Open_Terminal_as_root|open a terminal as '''root''']] and you must answer execute the prompt following: yum install cyrus-sasl{,-plain}: Restart Postfix systemctl restart postfix<!--* Add '''NEW''' users to continuethe foo.com domain (does not include any DNS MX records). Modify the '''mail''' database and substitute your information accordingly:*# Watch In the '''users''' table, insert a new record with the script following information...*#* ''user'': <u>user@foo.com</u>*#* ''password'': choose 'ENCRYPT' for errorsthe function and enter the users password. At 2 points(Alternatively, you will can have to provide responses 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 the script each forwarded email addresses to finish successfully<u>user@foo.com</u>*# At Run the first prompt for testing 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 pop3 server, just type quit''mail'' database and substitute your information accordingly:*# Scenario - Creating a mail domain e.g.:*# The second prompt you need to type ehlo localhost, then if everything appears ok then type quit* ''domain'' is: <u>bar.com</u>*# Once the script * ''server'' is complete, note the : <u>foo.bar.com</u>*#* ''admin user name and password'' is: <u>me@bar.com</u>*# In the mail mySQL database tables:*# Navigate to * ''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]].