Difference between revisions of "UtterChaosEmail"

From UtterChaos
Jump to: navigation, search
(screen tutorial)
(Updating old server name.)
 
(16 intermediate revisions by one other user not shown)
Line 1: Line 1:
This page contains information on how to use the UtterChaos email system provided on Siranna.
+
This page contains information on how to use the UtterChaos email system provided on Kemelin.
  
 
==Webmail==
 
==Webmail==
Webmail is easily accessed by connecting to https://siranna.utter-chaos.net/mail/
+
Webmail is easily accessed by connecting to https://gaerrim.utter-chaos.net/horde/
  
 
The more easily remembered http://mail.utter-chaos.net will redirect you to the secure URL.
 
The more easily remembered http://mail.utter-chaos.net will redirect you to the secure URL.
  
 
===Mail Filters===
 
===Mail Filters===
I suggest at the very least creating a Junk or Spam folder on your account and setting up a filter for incoming SPAM as follows:
+
This section details the creation of server side mail filters using horde. The steps below provide an example of how to setup a SPAM filter. The creation of any other filter rules should naturally extend from the example.
  
At mail.utter-chaos.net, Click the "Options" Tab. Then click "Mail Filters".
+
;Warning: If you have filters that are running from the old email system and they are not listed in the filter list as seen in the steps below, you will need to add them all now if you want them to continue to work. Once you've made any changes to your filters with the new system. The old ones will be deleted. Nybble has backups of the old filter rules if you need them.
  
Example Junk Mail Filter:
+
At mail.utter-chaos.net, Expand the "Mail" Tag by clicking on the "+" next to the Icon.
<pre>
+
If "Any Header" "Contains" "X-Spam-Status: Yes" then "move" to Folder "INBOX.Junk".
+
</pre>
+
("INBOX.Junk" is some folder that you created for your spam to be dropped into. It must be created before it can be selected here.)
+
  
Additional filters can be added here as well. The filter matching program starts at the top and works its way down. It only applies the first rule that it finds.
+
[[Image:MailTagExpand.png]]
 +
 
 +
Click the "Filter" Link under the "Mail" Application Tag
 +
 
 +
[[Image:MailFilterSelect.png]]
 +
 
 +
Click the "New Rule" Button to create a new Filter.
 +
 
 +
[[Image:MailFilterCreate.png]]
 +
 
 +
Fill out the Rule by using the one in the image below as an example. You should select the "Junk" or "Spam" folder that you created previously. Then click "Save."
 +
 
 +
[[Image:MailFilterSpam.png]]
 +
 
 +
To Make sure that your Mail Filters are running. Click on the "Script" Tab and then on the "Activate Script" button.
 +
 
 +
[[Image:MailFilterScript.png]]
 +
 
 +
If you want to make it so that you don't need to Activate the new script when you make changes like you did above. Do the following:
 +
 
 +
Click the "Options" tab. Check the "Automatically update the script after each change?" box. Then click the "Save Options" button.
 +
 
 +
[[Image:MailFilterOptions.png]]
 +
 
 +
Additional filters can be added here as well. The filter matching program starts at the top and works its way down. It only applies the first rule that it finds. I would recommend not using the Whitelist Filter provided by Horde because any address placed in it will not go through any of your filters. If you want white lists for spam purposes, check the SpamAssassin Config section below
  
 
==IMAP==
 
==IMAP==
This page specifies the appropriate configurations for an email client to connect to your email account on Siranna.
+
This section specifies the appropriate configurations for an email client to connect to your email account on Siranna.
  
 
===IMAPS===
 
===IMAPS===
  
Siranna only supports IMAP connections over SSL. This keeps your passwords safe and email archive secure.
+
Gaerrim only supports IMAP connections over SSL. This keeps your passwords safe and email archive secure.
  
#Configure your client to connect to siranna.utter-chaos.net on port 993 via SSL enabled IMAP. If your client does not support SSL, then you will need to find another client, figure out stunnel, or use the webmail services.
+
#Configure your client to connect to gaerrim.utter-chaos.net on port 993 via SSL enabled IMAP. If your client does not support SSL, then you will need to find another client, figure out stunnel, or use the webmail services.
 
#Configure your client to use password authentication (plaintext, not CRAM) and provide your username and password as needed.
 
#Configure your client to use password authentication (plaintext, not CRAM) and provide your username and password as needed.
#If your client asks, Siranna supports having messages and subfolders in the same folder. (Mozilla & Netscape ask this)
+
#If your client asks, Gaerrim supports having messages and subfolders in the same folder. (Mozilla & Netscape ask this)
  
 
===Setting up SMTPS===
 
===Setting up SMTPS===
  
Siranna will only relay messages from authenticated users. This method uses STARTTLS (SSL) enabled SMTP with authentication to protect a user/password login.
+
Gaerrim will only relay messages from authenticated users. This method uses STARTTLS (SSL) enabled SMTP with authentication to protect a user/password login.
  
 
#Configure your client to send email by SMTP.
 
#Configure your client to send email by SMTP.
#Choose siranna.utter-chaos.net as your outgoing mail server. The SSL/TLS port is 25. If port 25 does not work due to your ISP blocking it, use port 26. (If you live at Utter-Chaos, use port 26.)
+
#Choose gaerrim.utter-chaos.net as your outgoing mail server. The SSL/TLS port is 25. If port 25 does not work due to your ISP blocking it, use port 587 (The mail submission service port).
#Enable SSL for outgoing mail, and choose to always use SSL if appropriate for your client.
+
#Enable TLS/SSL for outgoing mail, and choose to always use TLS/SSL if appropriate for your client.
 
#Choose password authentication (not CRAM) for SMTP, and supply your username and password to your client as appropriate.
 
#Choose password authentication (not CRAM) for SMTP, and supply your username and password to your client as appropriate.
  
 
==SPAM==
 
==SPAM==
  
The antispam system on Siranna has support for a Bayesian statistical classifier. This classifier needs to be trained to identify SPAM and HAM (valid non-spam email). By default the system will try to learn what your SPAM & HAM look like based on the normal SPAM rules that are installed. This auto learning will only occur on new mail and will take take forever to learn well enough to be useful.
+
The antispam system on Gaerrim has support for a Bayesian statistical classifier. This classifier needs to be trained to identify SPAM and HAM (valid non-spam email). By default the system will try to learn what your SPAM & HAM look like.
 
+
If you have saved lots of messages (both HAM & SPAM) in separated folders, Nybble has written a script that will make use of your piles of crap that you have kept.
+
 
+
#ssh to siranna.utter-chaos.net
+
#Run 'learnspam.sh' at the prompt.
+
#Answer the questions that it asks you.
+
#Wait 1 hour.
+
#'logout' or 'exit'
+
 
+
For those of you who can't stay logged in for an hour to let this run, here is a quick tutorial on how to use screen:
+
#ssh to siranna.utter-chaos.net
+
#Run 'screen' at the prompt
+
#Run 'learnspam.sh' at the new blank prompt.
+
#Answer the questions that it asks you.
+
#Once it has started learning, type '<ctrl>a' then hit 'd'
+
#The screen will disappear leaving you with a prompt that says [detached]
+
#'logout' or 'exit'
+
at this point the learning process will continue while you do other stuff. When you want to check on it do this:
+
#ssh to siranna.utter-chaos.net
+
#Run 'screen -r' at the prompt
+
#Observe the progress
+
#If everything is done, then type 'exit' until you are logged out else follow step 5 above.
+
 
+
To make correcting mistakes easier, I have added SPAM/NOT SPAM buttons to the webmail interface. These buttons will tell the classifier to learn the message as the appropriate type. They do not move the message for you. I recommend placing SPAM that you have used the button on into your Junk/Spam folder so that later learning sessions can make use of it and not mistake it for HAM.
+
  
SPAM evolves over time so I recommend running the 'learnspam.sh' script occasionally (monthly)  or whenever it seems like it is missing lots of your SPAM or hitting lots of your HAM. Subsequent runs of the script should be faster than the first as the messages that it has already looked at before will be glossed over.
+
If the SPAM system misclassifies your email, just drag it into your Junk/Spam folder to relearn it as SPAM; or drag it out of your Junk/Spam folder to relearn it as HAM.

Latest revision as of 14:38, 16 September 2015

This page contains information on how to use the UtterChaos email system provided on Kemelin.

Webmail

Webmail is easily accessed by connecting to https://gaerrim.utter-chaos.net/horde/

The more easily remembered http://mail.utter-chaos.net will redirect you to the secure URL.

Mail Filters

This section details the creation of server side mail filters using horde. The steps below provide an example of how to setup a SPAM filter. The creation of any other filter rules should naturally extend from the example.

Warning
If you have filters that are running from the old email system and they are not listed in the filter list as seen in the steps below, you will need to add them all now if you want them to continue to work. Once you've made any changes to your filters with the new system. The old ones will be deleted. Nybble has backups of the old filter rules if you need them.

At mail.utter-chaos.net, Expand the "Mail" Tag by clicking on the "+" next to the Icon.

MailTagExpand.png

Click the "Filter" Link under the "Mail" Application Tag

MailFilterSelect.png

Click the "New Rule" Button to create a new Filter.

MailFilterCreate.png

Fill out the Rule by using the one in the image below as an example. You should select the "Junk" or "Spam" folder that you created previously. Then click "Save."

MailFilterSpam.png

To Make sure that your Mail Filters are running. Click on the "Script" Tab and then on the "Activate Script" button.

MailFilterScript.png

If you want to make it so that you don't need to Activate the new script when you make changes like you did above. Do the following:

Click the "Options" tab. Check the "Automatically update the script after each change?" box. Then click the "Save Options" button.

MailFilterOptions.png

Additional filters can be added here as well. The filter matching program starts at the top and works its way down. It only applies the first rule that it finds. I would recommend not using the Whitelist Filter provided by Horde because any address placed in it will not go through any of your filters. If you want white lists for spam purposes, check the SpamAssassin Config section below

IMAP

This section specifies the appropriate configurations for an email client to connect to your email account on Siranna.

IMAPS

Gaerrim only supports IMAP connections over SSL. This keeps your passwords safe and email archive secure.

  1. Configure your client to connect to gaerrim.utter-chaos.net on port 993 via SSL enabled IMAP. If your client does not support SSL, then you will need to find another client, figure out stunnel, or use the webmail services.
  2. Configure your client to use password authentication (plaintext, not CRAM) and provide your username and password as needed.
  3. If your client asks, Gaerrim supports having messages and subfolders in the same folder. (Mozilla & Netscape ask this)

Setting up SMTPS

Gaerrim will only relay messages from authenticated users. This method uses STARTTLS (SSL) enabled SMTP with authentication to protect a user/password login.

  1. Configure your client to send email by SMTP.
  2. Choose gaerrim.utter-chaos.net as your outgoing mail server. The SSL/TLS port is 25. If port 25 does not work due to your ISP blocking it, use port 587 (The mail submission service port).
  3. Enable TLS/SSL for outgoing mail, and choose to always use TLS/SSL if appropriate for your client.
  4. Choose password authentication (not CRAM) for SMTP, and supply your username and password to your client as appropriate.

SPAM

The antispam system on Gaerrim has support for a Bayesian statistical classifier. This classifier needs to be trained to identify SPAM and HAM (valid non-spam email). By default the system will try to learn what your SPAM & HAM look like.

If the SPAM system misclassifies your email, just drag it into your Junk/Spam folder to relearn it as SPAM; or drag it out of your Junk/Spam folder to relearn it as HAM.