#pragma section-numbers off

This page provides examples of how to get various email clients working with our setup.

<<TableOfContents>>

= MacOS X =

== Using our CA certificate ==

Doing this will get rid of the warning message for all SSL-enabled HCoop websites, as well as mail.  It will also get rid of the warning for any HCoop member websites served via HTTPS that have opted to be signed by our CA certificate.

 * Click on [[http://hcoop.net/ca/ca.crt]] using Safari to download our CA certificate.
 * Double-click the icon of the downloaded root certificate.
 * Choose X509 Anchors from the pop-up menu and click Add.
 * Enter an administrator password and click OK.

== Using just the email certificate ==

If you don't want to install the CA certificate, then it is possible to install just the certificate for mail.

=== The easy way ===

In mail.app when the warning about the certificate comes up, drag the certificate icon to a folder. Then drag this into keychain access into the system keychain, or open it with keychain access and specify "system".

=== The hard way ===

When using webmail, MacOS X always warns you about the root certificate not found. Mail.app does this as well. The solution for this problem is to do the following:

{{{
openssl s_client -showcerts -connect mail.hcoop.net:443
}}}

In that output look for "BEGIN CERTIFICATE" and "END CERTIFICATE". Between those lines there is the certificate. Copy that to a pem file. Then do:

{{{
certtool i hcoopmail.pem k=/System/Library/Keychains/X509Anchors v
}}}

It will import this into the X509Anchors keychain, the 'v' is for verbose. It should also say it imported successfully. Now Safari should not warn you about this.

= Symbian =

Hcoop email can be easily configured on your symbian mobile. This example is N91 specific, but other Symbian 9.1 phones should be very similar. IMAP4 configuration will be good if you like your mails to remain on the server.

 * Go to "Menu | Messaging".  From there choose "Options | Settings | E-mail". From there choose "Mailboxes | Options | New mailbox" and hit Start.

 * Choose "IMAP4" for the mailbox type and hit Next.
 * Enter your email address in "My email address" and hit Next.
 * Enter "mail.hcoop.net" as your "Incoming mailserv." and hit Next.
 * Enter "mail.hcoop.net" as your "Outgoing mailserv." and hit Next.
 * Choose an access point that you will mostly use.
 * Give your mailbox a name eg:user_mydomain and hit OK to create the mailbox.

Your mailbox name will appear in the list of mailboxes.

 * Go on and select the mailbox name | "Connection Settings" | "Incoming Email".
 * Enter your username and password and change "Security(ports)" setting to "SSL/TLS" and change "Port" to "993".
 * Go on to configure "Outgoing mail" using the same settings with "Port" as "465".

 * Go back to "Menu | Messaging" and you will see your mailbox appear in the list. Open it and hit "Options | Connect" to read your mail.

= Android =

This is the configuration for the default 'Email' application on Android. 

 * On the first time setup screen, tap on the 'Manual Setup' button on the bottom left corner.
 * Tap on the IMAP button
 * Fill in the fields Username and Password
 * "IMAP server" : mail.hcoop.net
 * "Port" : 993
 * "Security Type" : SSL (Accept all certificates)
 * Tap 'Next'
 * For the outgoing server settings choose "SMTP Server" : mail.hcoop.net
 * "Port" : 465
 * "Security Type" : None
 * Leave the 'Require sign-in' box unchecked.


= OLPC =

At the time of this writing, the only way to access email from an [[http://laptop.org|OLPC laptop]] is via [[https://mail.hcoop.net]], and there is no easy way to successfully browse that site, due to a bug in the OLPC web browser.  Here is how to work around the issue.

== Prerequisites ==

 * Another computer with Internet access must be present.
 * The {{{certutil}}} tool must be installed on your other computer.  For Debian and Ubuntu, this means installing the {{{libnss3-tools}}} package.
 * You must have either a USB thumb drive or an SD card with card reader.

== Instructions ==

 * Insert the USB thumb drive or SD card into the OLPC.
 * Bring up the Terminal activity on the OLPC.
 * Figure out where the card or drive has been mounted.  This can be done by typing {{{ls /media}}} and looking for a folder of the form {{{XXXX-XXXX}}}.  We'll denote this path as '''$DIR'''.
 * {{{
mkdir $DIR/mozilla}}}
 * {{{
cp ~/.sugar/default/gecko/*.db $DIR/mozilla}}}
 * Unmount the drive or card by bringing up the Journal activity, hovering over the icon, and clicking "Unmount".
 * Insert the card or drive into your computer.  Figure out where the drive was mounted -- we'll denote this as '''$DRIVE'''.
 * Download [[http://hcoop.net/ca/ca.crt]].
 * Switch to the directory where you downloaded that file.
 * {{{
certutil -A -n hcoop -t C,C,C -d $DRIVE/mozilla -i ca.crt}}}
 * Unmount the drive or card from your computer.  Mount it into the OLPC again.
 * Close any Browse activities that you may have open.
 * Switch to the Terminal activity and run {{{
cp $DIR/mozilla/*.db ~/.sugar/default/gecko/}}}
 * Future instances of the Browse activity will then be able to browse HTTPS hcoop websites.

= Mutt =

{{{
#
# ~/.muttrc
#
set certificate_file=~/.mutt/certs
set folder=imaps://mail.hcoop.net/INBOX.
set from=user@hcoop.net
set header_cache=~/.mutt/cache/hdrs
set imap_idle=yes
set imap_keepalive=300
set imap_passive=no
set imap_user=user
# set imap_pass=password
set mbox=imaps://mail.hcoop.net/INBOX
set mail_check=300
set message_cachedir=~/.mutt/cache/msgs
set move=no
set postponed=+Drafts
set record=+Sent
# set realname=Your Other Name
set smtp_url=smtps://user:password@mail.hcoop.net
set spoolfile=imaps://mail.hcoop.net/INBOX
}}}

= Alpine =
You can also check your hcoop email using Alpine.  To do so, simply type 'alpine' at the prompt.  This will invoke the Alpine client, but as is, it won't be able to access your messages, or send new ones.  You will need to configure a few settings first.

 * Press s (for Setup) and then c (for Config).  This will allow you to make the necessary edits to your .pinerc file. 
 * Follow the on screen instructions to first enter your desired name under Personal Name.  This will fill in the text in the from section on each email that you send.  Save this info, and then go down a line.  
 * For User Domain, type hcoop.net and save this too.    
 * On the line SMTP Server (for sending), type in mail.hcoop.net/novalidate-cert , and then save the line. 
 * Skip down to the line called Inbox path, and enter the following: mail.hcoop.net/ssl/novalidate-cert/user=''your-user-name'' where your-user-name is, you guessed it, your login name.  Save this info.  
 * As you can see, there are a bazillion other settings that you can customize here, but for now leave them alone, you can come back and change them later.  Press e (for Exit Setup).  

You have just done everything that you need to do to read incoming mail, and send outgoing messages.  The next (and last) thing you will probably want to do, is to get access to other folders that you may have created/want to create.  

To do this, 
 * Press `m` to get back to the Main menu, then press `s` to enter Setup, then press `l` for Collection '''L'''ists. 
 * Press c to update the Folder Collection entry.
 * In the Nickname field, type IMAP folders.  
 * In the Server field, type imap.hcoop.net/user=''username''/ssl/novalidate-cert where username is your login id.
 * Press ctl-x to exit the setup and y to confirm that you wish to save your changes.
 * Press q to quit alpine, and then y to confirm. 
 * Now back at the prompt, type alpine to start the program again.  Alpine will fill in your login id, but you will need to enter your password.  
 * Press i to view any messages in your inbox.  

You can now browse your mail and compose messages using Secure IMAP and Secure SMTP.
----
CategoryMemberManual