This page provides examples of how to get various email clients working with our setup.
Contents
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 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 Lists.
- 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.