{{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 [http://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. * 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, [Categoryhttp:Apps//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]].

<b>DISCLAIMER:</b> Although this has been tested==== Current Version ====1.05 ([[Fedora_19|Fedora 19]]) released January 1, use at your own risk. I cannot guarantee that it will work for your system or not cause any serious problems.2014

=== Current Version =Change Log ====* Upgraded to [[Amahi_7|Amahi 7]] on [[Fedora_19|Fedora 19]]* Added 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 better cleanup* Added script to update mail certificate1.5 as of 3 Oct 09* Inserted additional logging messages

==== Version Changes How to Install/Uninstall (Automated) ====* Added option for secure(https) or unsecure(Special access must be requested to install [http) webmail access://www.amahi.org/apps/amahi-mail-system Amahi Mail System].* Once granted, install/uninstall via the Applications tab in the Amahi Dashboard.

The primary intent Here's the sequence of events to get the virtual email server up and running:# 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 Mail System is named '''ams''' (Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this capability.).# Navigate to '''''/var/hda/web-apps/ams''''' directory.# Download [https://dl.dropboxusercontent.com/u/1380867/mail-server-1.05.zip mail-server-1.05.zip] (sha1sum 4d5623d5d00a4d66512455deaec688fc49a34782) to this directory and extract it into '''''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 called '''''elevated''''' in '''''ams'''''. Copy mail-setup.sh and del-maildir.sh to that location.# Ensure mail-setup.sh and del-maildir.sh are executable.# Create the database and insert the data from the mail.sql file located in the '''''config''''' directory. # Navigate to allow <b><nowiki>http://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 pull change the login info).# Complete all ISP email into the required info. Once finished, select the click the '''NEXT''' 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 servernew mail account. Keep # Use the built-in tool to manage Virtual User information in mind this is still under developmentthe 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.

* It allows you to send===== Example Install Terminal Session =====<pre>su -cd /var/hda/web-apps/receive mail from your HDA. There are some quirks depending on if you have a registered domain with a paid service provider (i.e. [httpamswget https://wwwdl.godaddydropboxusercontent.com GoDaddy], [http:/u/1380867/mail-server-1.05.zipmkdir -p elevatedcd htmlunzip ../wwwmail-server-1.hostgator05.com Host Gator])zipchmod 755 *.shchown -R apache:users * . With these services, there is typically what is called a MX record associated with the domain name. This will allow you to send/receive elevatedcp mail as your hostname (i-setup.sh ../elevatedcp del-maildir.esh . myhda@home.com)/elevatedhda-create-db-and-user mailmysql -umail -pmail mail < config/mail. sql</pre>

* If you use ==== How to Uninstall (Manual) ====To uninstall, do the free ones (ifollowing:# Open terminal [[Open_Terminal_as_root|as '''root''' user]], and navigate to '''''/var/hda/web-apps/ams/html''''' directory.e# Remove the database. user# Ensure mail-remove.yourhdash is executable.com# From the '''''html''''' directory, run the script. This may take a while to complete.# Remove the web app in Amahi named '''ams''' (Amahi application [httphttps://www.no-ipamahi.org no/apps/web-ip.orgapps Web App]), you will have to masquerade your email address as your ISP (i.eprovides this capability. myhda@yourisp.com). This will ensure you can receive email replies from those you send from your HDAand close the terminal window.

==== PreAdd-Configuration 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 ====

* Since You can change the Postfix RPM was built custom, it needs to be excluded from updates. Failure to do so could break your Amahi Mail System after updatesLogin Credentials for the integrated database manager/web-based installer by doing the following:** Open the Login-class. Make php file in the following change to '''''/etcvar/yum.confhda/web-apps/ams/html''''':directory** On lines 29 and 32, change to whatever works for you exclude=postfix** Save and now you can log in using the new credentials

==== Script download links: ====* Update mail certificate32** Should you need to update the mail certificates, use the mail-bit: http://dlcert-update.sh script.getdropbox** 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.com/u/1380867/32bit-virtual-** Once complete, you can execute the script to update the mail-1.5.tarserver certificates.gz<br />64 su -bit: http:cd /var/dl.getdropbox.comhda/uweb-apps/1380867ams/64bit-virtualhtml ./mail-mailcert-1.4.tarupdate.gz<br />sh

Here====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'''s user]] and do the sequence of events to following:<pre>cd /var/hda/web-apps/ams/html./mail-stop.sh./mail-start.sh</pre> * If you get the virtual email server up message " warning: SASL authentication failure: No worthy mechs found." [[Open_Terminal_as_root|open a terminal as '''root''']] and runningexecute the following:# yum install cyrus-sasl{,-plain}: Restart your HDA so itPostfix systemctl restart postfix<!--* Add '''NEW'''s fresh for users to the installfoo.com domain (does not include any DNS MX records). This is not requiredModify the '''mail''' database and substitute your information accordingly:*# In the '''users''' table, just insert a recommendationnew record with the following information...*# Create a web app in Amahi named * ''user'': <u>user@foo.com</u>*#* ''password'webmail': choose 'ENCRYPT'for the function and enter the users password.(Alternatively, you can have the user enter their password)*# Open a terminal window, become * ''quota'': do NOT edit this field (unless you know what you are doing)*# In the '''rootforwardings'''table, and navigate insert a new record for each forwarded email addresses to <u>user@foo.com</u>*# 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/webmail<ams/html/config/u> directorywelcome.txt}}# Download script file * Add an additional mail domain (pick does not include any DNS MX records). Modify the correct one for ''mail'' database and substitute your system) to this directory and extract it into information accordingly:*# Scenario - Creating a mail domain e.g. :*#* ''domain'' is: <u>htmlbar.com</u> directory of webmail*#* ''server'' is: <u>foo.bar.com</u>*# From the * ''admin user'' is: <u>htmlme@bar.com</u> directory, run *# In the mail mySQL database tables:*#* ''domain''host-update-virtual-mail-1: add <u>bar.4.shcom</u>*#* ''transport'' script. : This will check your hostname. If it is not correct, you will be given an opportunity to change itadd <u>bar.com</u>*# Answer all the questions. The answers will further customize your install. * ''user''Note: add <u>me@bar.com</u>*#* ''forward'' : Mail user name add <u>postmaster@bar.com</u>, and password must be one word only (i<u>abuse@bar.ecom</u> to <u>me@bar. mailuser or mail_user are acceptable)com</u>*# Once it completes, run Run the command line below to set up the '''install-virtual-mail-1''/home/vmail/bar.4.shcom/me''''' scriptmail files:{{Code|mailx -s Welcome me@bar. The dependencies will com < /var/hda/web-apps/ams/html/config/welcome.txt}}* For every domain supported, the following either need to be installed firstadded as users or forwarded. Depending Without them a site MAY end up on your system, 66 is the typical amount for installvarious spam block lists:{{Text|Text=postmaster@foo.com# Watch the script abuse@foo.com}}--><!--* Some ISPs block port 25 for errorsmail. This may help narrow down the problem if you cannot log inThus a remote user would be able to retrieve mail, but not send mail.# Once the script To accommodate this, port 587 is complete, note the user name and passwordused by email clients for sending mail.*# Navigate to <u>http:To enable port 587, edit '''''/etc/webmail<postfix/u> and enter your login credentialsmaster.# To uninstall, run the cf'''''uninstalland uncomment the line starting with "# submission"*# Reload postfix -virtual-mail-1> ==== 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.4amahi.sh''' scriptorg 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]].