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://deleuze.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 deleuze.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 "deleuze.hcoop.net" as your "Incoming mailserv." and hit Next.
• Enter "deleuze.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.

OLPC

At the time of this writing, the only way to access email from an [http://laptop.org OLPC laptop] is via [https://mail2.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 folder 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://deleuze.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.