Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Known Issues
{{MessageBox|backgroundcolor = AliceBlue #FBB|image =Msgbox-WOPrWarning.pngpng|heading =Work In ProgressWARNING|message = Converting to Fedora 14This 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 ([[Category:AppsIntro|HDA]]) as a mail server.
==== Purpose Current Version ====The primary intent of the Amahi Mail System is to allow you to pull all ISP email into your server1. Keep in mind this is still under development. 05 ([[Fedora_19|Fedora 19]]) released January 1, 2014
==== Known Issues ====* During the configuration, the ClamAV definitions download sometimes takes too long. It allows you can cause the setup to send/receive mail from your HDA. There are some quirks fail, depending on if you have a registered domain with a paid service provider (iavailability of their server.e** The proposed work around is to run the ClamAV virus definition update after setup is complete. [http:** Comment out line 164 (<code>/usr/www.godaddy.com GoDaddy], [http:bin/freshclam -v</wwwcode>) in ''mail-setup.hostgator.com Host Gator])sh'' script. With these services, there ** Run this separately after configuration is typically what is called a MX record associated with complete when you will see the domain namenotification ''You have 2 new messages. This will allow you to send/receive mail as your hostname (i.e. myhda@home.com). ''
==== Change Log ====* If you use the free ones (i.e. user.yourhda.com, Upgraded to [[Amahi_7|Amahi 7]] on [http://www.no[Fedora_19|Fedora 19]]* Added 32-ip.org no-ip.org]), you will have to masquerade your email address as your ISP (i.e. myhda@yourisp.com). This will ensure you can receive email replies bit binaries* Changed web page background color* Remove quota info from those you send web pages* Enable port 587 for sending mail* Removed mail quota from your HDA.Postfix configuration* Fixed certificate errors when using spaces'''Note:''' There is now a complete guide * Streamlined uninstall script for better cleanup* Added script to installing the Amahi Mail System with a free ddns and using a gmail account at [http://wiki.amahi.org/index.php/Amahi_Mail_-_The_Free_Way Amahi Mail - The Free Way].update mail certificate* Inserted additional logging messages
==== Current Version Future Enhancements ====1.75 * Expand instructions to include how to configure mail clients* Incorporate a mail backup mechanism* Streamline code and validate form fields* Move mailbox data files to share (Fedora 12See [[Amahi_Mail_System#Tips|Tips]] below) released 9 Feb 10
==== How to Install/Uninstall (Automated) ====* Special access must be requested to install [http://wikiwww.amahi.org/images/1/1capps/amahi-mail-system Amahi-Mail-System].* Once granted, install/uninstall via the Applications tab in the Amahi Dashboard.PNG Login Screen Shot]
==== Change Log How to Install (Manual) ====* Working upgrade for Fedora 14
==== Updated RPMs (20 Nov 10) = Example Install Terminal Session =====32<pre>su -cd /var/hda/web-bit: httpapps/amswget https://dl.dropboxdropboxusercontent.com/u/1380867/32mail-bitserver-1.05.zipmkdir -rpmp elevatedcd htmlunzip .tar.gz<br />mail-server-1.05.zipchmod 755 *.sh64chown -bit: httpR apache:users * ../elevatedcp mail-setup.sh ../dlelevatedcp del-maildir.sh .dropbox.com/u/1380867/64elevatedhda-create-db-and-user mailmysql -bitumail -rpmspmail mail < config/mail.tar.gzsql</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.sh is executable.
# From the '''''html''''' directory, run the script. This 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.
==== How to Install Add-Ons ====Here's the sequence of events to get the virtual email server up and running:# Restart your 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 a web app in Amahi named '''webmail'''.# Open a terminal window, become '''root''', and navigate to <u>/var/hda/web-apps/webmailMailman</u> directory.# Download script file (pick the correct one for your system) to this directory and extract it into <u>html</ubr> directory of webmail.# From You can now add the <u>html</u> directory, run the '''host-update-virtual-mail-1.75.sh''' script. This will check your hostname. If it is not correct, you will be given an opportunity Mailman software to change it (See '''NOTE''' below for unusual host names).# Answer all the questions. The answers will further customize your install. '''Note:''' Amahi Mail user name and password must be one word only (i.e. mailuser, mail_user, or mail.user are acceptable)# Once it completes, run the '''install-virtual-mail-1.75.sh''' script. The dependencies will be installed firstSystem. Depending on your system, 68 is Follow the typical amount for install on a new systeminstructions at [http://wiki.# Watch the script for errorsamahi. This may help narrow down the problem if you cannot log inorg/index.# Once the script is complete, note the user name and passwordphp/Amahi_Mailman Amahi Mailman].# Run the following, selecting #2 so that postfix is used to send mail:{{Code|/usr/sbin/alternatives --config mta}}
==== Tips ====
* To permanently change your hostname from '''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. * 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; ==== Future Plans Troubleshooting====* Add additional Squirrelmail 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 [[httpOpen_Terminal_as_root|as '''root''' user]] and do the following:<pre>cd /var/hda/web-apps/ams/squirrelmailhtml.org/pluginsmail-stop.sh./mail-start.sh</pre> * If you get the message " warning: SASL authentication failure: No worthy mechs found.php plugins" [[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:* Database front end to manage # In the '''users''' table, insert a new record with the following information...*#* ''user'': <u>user@foo.com</u>*#* ''password'': choose 'ENCRYPT' for the function and enter the userspassword. (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, accountsinsert 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/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>*#* ''transport'': add <u>bar.com</u>*#* ''user'': add <u>me@bar.com</u>*#* ''forward'': add <u>postmaster@bar.com</u>, etcand <u>abuse@bar.com</u> to <u>me@bar.com</u>* Include interface with fetchmail # Run the command line below to automatically retrieve set up the '''''/home/vmail/bar.com/me''''' mailfiles:{{Code|mailx -s Welcome me@bar.com < /var/hda/web-apps/ams/html/config/welcome.txt}}* Change dependency For every domain supported, the following either need to be added as users or forwarded. Without them a site MAY end up on MYSQL root various spam block lists:{{Text|Text=postmaster@foo.comabuse@foo.com}}--><!--* 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 database creationsending mail.*# To enable port 587, edit '''''/etc/postfix/master.cf''''' and uncomment the line starting with "# submission"*# Reload postfix -->
==== Conclusion ====
You should now be able to log in to your account via webmail. There will be 2 messages, one is a welcome and the other is a SPAM test to show it's working. I forgot Direct any questions or comments to mention that you can access the mail server from any email client (i[https://forums.eamahi. Thunderbird, MS Outlook, etc) as well within your networkorg the forums].
