Amahi Wiki - User contributions [en]

Amahi Mail System

2011-01-11T03:20:48Z

Jinxy:

[[Category:Apps]]

==NOTE: This should only be attempted by advanced users.==

DISCLAIMER: 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.

==== Purpose ====
The primary intent of the Amahi Mail System is to allow you to pull all ISP email into your server. Keep in mind this is still under development.

* It allows 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 (i.e. [http://www.godaddy.com GoDaddy], [http://www.hostgator.com Host Gator]). 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]), 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.
'''Note:''' There is now a complete guide 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].

==== Current Version ====
1.75 (Fedora 12) released 9 Feb 10

[http://wiki.amahi.org/images/1/1c/Amahi-Mail-System.PNG Login Screen Shot]

==== Change Log ====
* Working upgrade for Fedora 14

==== Script download links: ====
32-bit: http://dl.getdropbox.com/u/1380867/32bit-virtual-mail-1.75.tar.gz 
64-bit: http://dl.getdropbox.com/u/1380867/64bit-virtual-mail-1.75.tar.gz 

==== Updated RPMs (20 Nov 10) ====
32-bit: http://dl.dropbox.com/u/1380867/32-bit-rpm.tar.gz 
64-bit: http://dl.dropbox.com/u/1380867/32-bit-rpms.tar.gz

'''NOTE:''' These have not been added to the the download above or the install scripts yet. Also, ''maildrop'' is now part of the Fedora repo and no longer needs to be custom built.

==== How to Install ====
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 /var/hda/web-apps/webmail directory.
# Download script file (pick the correct one for your system) to this directory and extract it into html directory of webmail.
# From the html 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 to change it (See '''NOTE''' below for unusual host names).
# Answer all the questions. The answers will further customize your install. '''Note:''' 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 first. Depending on your system, 68 is the typical amount for install on a new system.
# Watch the script for errors. This may help narrow down the problem if you cannot log in.
# Once the script is complete, note the user name and password.
# Run the following, selecting #2 so that postfix is used to send mail:
/usr/sbin/alternatives --config mta

'''NOTE:''' Within a network it is possible to have a hostname that consists of xxx.xxx.xxx.xxx which this script can not recognize. Instead modify line 13 domnm=your.domain.name then run the script, all should be good (it is very rare to have a 4 level domain).
* Navigate to http://webmail and enter your login credentials.
* To uninstall, run the '''uninstall-virtual-mail-1.75.sh''' script.

==== Tips ====
* To permanently change your hostname from '''localhost.localdomain''', see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article].
* For https, most certificates are self-signed. You may need to follow the procedures listed [[Web_Browser_Tips|here]] when accessing [http://webmail http://webmail].
* These are the steps needed to add '''NEW''' users to the foo.com domain (does not include any DNS MX records). Use [http://www.amahi.org/apps/phpmyadmin phpMyAdmin] to modify the ''mail'' database and substitute your information accordingly.
** In the '''mail''' mySQL database:
*** In the '''users''' table:
**** Insert a new record with the following information...
***** ''user'': user@foo.com
***** ''password'': choose 'ENCRYPT' for the function and enter the users password. (Alternatively, you can have the user enter their password and click the "Go" button)
***** ''quota'': do NOT edit this field (unless you know what you are doing)
***** Click the "Go" button
*** In the '''forwardings''' table:
**** Insert a new record for each forwarded email addresses to user@foo.com and click the "Go" button
** Run the command line below to set up the /home/vmail/foo.com/user mail files:
mailx -s Welcome user@foo.com < /var/hda/web-apps/webmail/html/patch/welcome.txt
* These are the steps needed to add an additional mail domain (does not include any DNS MX records). Use [http://www.amahi.org/apps/phpmyadmin phpMyAdmin] to modify the ''mail'' database and substitute your information accordingly.
** Creating a mail domain e.g. :
*** ''domain'' is: bar.com
*** ''server'' is: foo.bar.com
*** ''admin user'' is: me@bar.com
** In the mail mySQL database tables:
*** ''domain'': add bar.com
*** ''transport'': add bar.com
*** ''user'': add me@bar.com
*** ''forward'': add postmaster@bar.com, and abuse@bar.com to me@bar.com
** Run the command line below to set up the /home/vmail/bar.com/me mail files:
mailx -s Welcome me@bar.com < /var/hda/web-apps/webmail/html/patch/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:
postmaster@foo.com
abuse@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 sending mail.
** To enable port 587, edit /etc/postfix/master.cf and uncomment the line starting with "# submission"
** Reload postfix
* Add capability to fetch Yahoo mail:
# Download the latest [http://fetchyahoo.twizzler.org/ FetchYahoo]
# Install instructions included

==== Future Plans ====
* Add additional Squirrelmail [http://squirrelmail.org/plugins.php plugins].
* Database front end to manage users, accounts, etc.
* Include interface with fetchmail to automatically retrieve mail.
* Change dependency on MYSQL root user for database creation.

==== 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 to mention that you can access the mail server from any email client (i.e. Thunderbird, MS Outlook, etc) as well within your network.

==== Mailman addon option ====
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].

NOTE: These scripts were adapted from a tutorial authored by Falko Timme at [http://www.howtoforge.com/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-12-x86_64 http://www.howtoforge.com/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-12-x86_64].

Amahi Mail System

2011-01-09T23:25:21Z

Jinxy:

[[Category:Apps]]

==NOTE: This should only be attempted by advanced users.==

DISCLAIMER: 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.

==== Purpose ====
The primary intent of the Amahi Mail System is to allow you to pull all ISP email into your server. Keep in mind this is still under development.

* It allows 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 (i.e. [http://www.godaddy.com GoDaddy], [http://www.hostgator.com Host Gator]). 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]), 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.

==== Current Version ====
1.75 (Fedora 12) released 9 Feb 10

[http://wiki.amahi.org/images/1/1c/Amahi-Mail-System.PNG Login Screen Shot]

==== Change Log ====
* Working upgrade for Fedora 14

==== Script download links: ====
32-bit: http://dl.getdropbox.com/u/1380867/32bit-virtual-mail-1.75.tar.gz 
64-bit: http://dl.getdropbox.com/u/1380867/64bit-virtual-mail-1.75.tar.gz 

==== Updated RPMs (20 Nov 10) ====
32-bit: http://dl.dropbox.com/u/1380867/32-bit-rpm.tar.gz 
64-bit: http://dl.dropbox.com/u/1380867/32-bit-rpms.tar.gz

'''NOTE:''' These have not been added to the the download above or the install scripts yet. Also, ''maildrop'' is now part of the Fedora repo and no longer needs to be custom built.

==== How to Install ====
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 /var/hda/web-apps/webmail directory.
# Download script file (pick the correct one for your system) to this directory and extract it into html directory of webmail.
# From the html 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 to change it.
NOTE: within my network my hostname consists of xxx.xxx.xxx.xxx which this script can not recognise. Instead modify line 13 domnm=your.domain.name then run the script, all should be good (it is very rare to have a 4 level domain so in most cases ignore this).
# Answer all the questions. The answers will further customize your install. '''Note:''' 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 first. Depending on your system, 68 is the typical amount for install on a new system.
# Watch the script for errors. This may help narrow down the problem if you cannot log in.
# Once the script is complete, note the user name and password.

'''NOTE:''' Run the following, selecting #2 so that postfix is used to send mail:
/usr/sbin/alternatives --config mta

* Navigate to http://webmail and enter your login credentials.
* To uninstall, run the '''uninstall-virtual-mail-1.75.sh''' script.

==== Tips ====
* To permanently change your hostname from '''localhost.localdomain''', see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article].
* For https, most certificates are self-signed. You may need to follow the procedures listed [[Web_Browser_Tips|here]] when accessing [http://webmail http://webmail].
* These are the steps needed to add '''NEW''' users to the foo.com domain (does not include any DNS MX records). Use [http://www.amahi.org/apps/phpmyadmin phpMyAdmin] to modify the ''mail'' database and substitute your information accordingly.
** In the '''mail''' mySQL database:
*** In the '''users''' table:
**** Insert a new record with the following information...
***** ''user'': user@foo.com
***** ''password'': choose 'ENCRYPT' for the function and enter the users password. (Alternatively, you can have the user enter their password and click the "Go" button)
***** ''quota'': do NOT edit this field (unless you know what you are doing)
***** Click the "Go" button
*** In the '''forwardings''' table:
**** Insert a new record for each forwarded email addresses to user@foo.com and click the "Go" button
** Run the command line below to set up the /home/vmail/foo.com/user mail files:
mailx -s Welcome user@foo.com < /var/hda/web-apps/webmail/html/patch/welcome.txt
* These are the steps needed to add an additional mail domain (does not include any DNS MX records). Use [http://www.amahi.org/apps/phpmyadmin phpMyAdmin] to modify the ''mail'' database and substitute your information accordingly.
** Creating a mail domain e.g. :
*** ''domain'' is: bar.com
*** ''server'' is: foo.bar.com
*** ''admin user'' is: me@bar.com
** In the mail mySQL database tables:
*** ''domain'': add bar.com
*** ''transport'': add bar.com
*** ''user'': add me@bar.com
*** ''forward'': add postmaster@bar.com, and abuse@bar.com to me@bar.com
** Run the command line below to set up the /home/vmail/bar.com/me mail files:
mailx -s Welcome me@bar.com < /var/hda/web-apps/webmail/html/patch/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:
postmaster@foo.com
abuse@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 sending mail.
** To enable port 587, edit /etc/postfix/master.cf and uncomment the line starting with "# submission"
** Reload postfix
* Add capability to fetch Yahoo mail:
# Download the latest [http://fetchyahoo.twizzler.org/ FetchYahoo]
# Install instructions included

==== Future Plans ====
* Add additional Squirrelmail [http://squirrelmail.org/plugins.php plugins].
* Database front end to manage users, accounts, etc.
* Include interface with fetchmail to automatically retrieve mail.
* Change dependency on MYSQL root user for database creation.

==== 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 to mention that you can access the mail server from any email client (i.e. Thunderbird, MS Outlook, etc) as well within your network.

==== Mailman addon option ====
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].

NOTE: These scripts were adapted from a tutorial authored by Falko Timme at [http://www.howtoforge.com/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-12-x86_64 http://www.howtoforge.com/virtual-users-domains-postfix-courier-mysql-squirrelmail-fedora-12-x86_64].

Translate Amahi

2011-01-05T02:10:38Z

Jinxy:

Multiple languages and localization are supported Amahi for a while.

= Please help with Amahi translations =

We are currently in need of contributers to translate Amahi to your language.

Translation is really very easy using our online translation site and is the preferred way to make Amahi available in your language!

If you are interested in contributing get in touch with us at amahi org, via the forums or the irc channel, PM Jinxy, CPG or pjcrux

= How to Translate Amahi offline =

This method achieves the same goals, in a more "manual" way.

It involves converting a "master" english file (en.yml) to a file in your own language.

Here is the [http://git.amahi.org/?p=amahi.git;a=blob;f=platform/platform/html/config/locales/en.yml;h=05555fc01e55cf7036b1c9cd69c96d843a55683d;hb=HEAD en.yml file] set of sentences to translate (in a format called yml, ready for rails 2.3).

(that's formatted) the raw file is at [http://git.amahi.org/?p=amahi.git;a=blob_plain;f=platform/platform/html/config/locales/en.yml;hb=HEAD raw en.yml]

Basically what the translation consists of is this:

* duplicate the original file, change the name to something appropriate (e.g. de.yml for german, fr for french)
* change the strings after the colon to the end of the line for the new language.

That's it! you can do it by cut and paste or with git:

<code>
git clone git://git.amahi.org/amahi.git
cd amahi/platform/platform/html/config/locales
cp en.yml yourlocale.yml
[edit the yourlocale.yml file]
git commit yourlocale.yml
</code>

For brownie points, you can also add those to
amahi/platform/platform/html/app/controllers/setup_controller.rb

To find the code of your language, please visit [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes the iso codes page]
Columns 6 is the name of the language *in the native language* (we need that) and column 1 is the ISO code

Please put them here in alphabetical order so that the user can more easily find his/hers!

Here is how to [http://forums.amahi.org/viewtopic.php?f=15&t=188&start=0#p880 submit a patch directly] with git or you can send your locale file by email or post it in the forums or amahi-devel list.

Here is the original [http://forums.amahi.org/viewtopic.php?f=15&t=188&start=0 localization thread in the forums].

= Translation Tips =

We have some important translation tips that you must read before attempting translation. Sounds simple, but there are a few interesting wrinkles to it:

[[Translation tips]]