≡ Menu

Courier IMAP SSL Server Certificate Installtion and Configuration

The Courier mail server is a mail transfer agent (MTA) server that provides ESMTP, IMAP, POP3, webmail, and mailing list services with individual components. But, it is best known for its IMAP / IMAPs and POP3 / POP3s (secure version) server component.

Courier can provides support for both regular UNIX operating system account (stored in /etc/passwd) and virtual mail account managed by third party backends such as OpenLDAP, MySQL and so on.

In this quick tutorial, you will learn about installing Courier IMAP SSL digital certificate.

Out setup is as follows:

  • SMTP Server: smtp.theos.in
  • Courier IMAP / POP3 Server: smtp.theos.in

Generating a CSR and private key for Courier IMAP SSL Server

Type the command to create a SSL CSR for a mail server called smtp.theos.in:
# mkdir -p /usr/local/ssl
# cd /usr/local/ssl
# openssl req -new -nodes -keyout smtp.theos.in.key -out smtp.theos.in.csr

Most important is Common Name, in our example it is set to smtp.theos.in. For the common name, you should enter the full Courier IMAP server address of your site.

Submit CSR to CA

Next logical step is copy and paste the contents of the CSR file into the SSL certificate providers (aka CA) account and get final certificate.

Install your SSL certificate

Unzip file and upload certificates to /usr/local/ssl directory. You also need to upload your CA's intermediate certificate. Now, you should have 4 file as follows:

  1. /usr/local/ssl/intermediate.crt
  2. /usr/local/ssl/smtp.theos.in.crt
  3. /usr/local/ssl/smtp.theos.in.csr
  4. /usr/local/ssl/smtp.theos.in.key

Now create /usr/local/ssl/smtp.theos.in.pem a combined .pem certificate file:
# cat /usr/local/ssl/smtp.theos.in.crt /usr/local/ssl/smtp.theos.in.key > /usr/local/ssl/smtp.theos.in.pem

Configure Courier IMAP SSL Certificate

Open your courier IMAP configuration file such as /usr/local/etc/courier-imap/imapd-ssl and make set directives as follows:

Save and close the file. Make sure that the file permissions are set correct and only root can read all files located in /usr/local/ssl directory. Restart Courier IMAP server:
# /usr/local/etc/rc.d/courier-imap-imapd-ssl restart

Test your installation

Use openssl utility to test configuration:
$ openssl s_client -connect smtp.theos.in:993
You should not see any error or warning message regarding SSL certificate.

Share this on:

{ 6 comments… add one }

  • luciano rinetti May 27, 2011, 2:49 pm

    How can i autogenerate a certificate without a CA ?

  • Bob July 4, 2011, 10:26 pm

    You may want to add a -CApath parameter to the check command, otherwise openssl will complain about “self signed certificate in certificate chain”.
    It took me several hours and lots of downloads of RapidSSL/Geotrust intermediate and CA certs to figure this one out.


    openssl s_client -connect -CApath /etc/ssl/certs smtp.theos.in:993

  • Richard July 30, 2011, 8:50 pm

    Hey Bob – You just saved me hours thanks mate for -CApath patch. Taa saves me from the RapidSSL / Geotrust Cheers mate

  • p January 3, 2013, 12:57 pm

    Thanks Bob

  • ashwin January 9, 2013, 8:31 pm

    I see that courier is not in rhel repos for a long time . Do you know why ?

  • Arjun May 12, 2013, 5:11 am

    After the following steps, you also need to move the generated .pem file to the /etc/courier folder and rename it as imapd.pem and pop3d.pem

Leave a Comment

   Tagged with: , , , , , , , , , , , , , , , , , , ,