IMAP Email Client Configuration

This document covers configuration of the following IMAP clients that support connecting to a secure IMAP server. In most cases, you will need an Application Passcode obtained from Zimbra to use as your password for all of these clients:

Make sure you read the NOTE at the bottom of this page.

Settings Summary:
IMAP (Incoming) Server: imap.cs.princeton.edu
IMAP Settings / Port: SSL / Port 993
SMTP (Outgoing) Server: smtp.cs.princeton.edu
SMTP Settings / Port: TLS with Authentication / Port 587

Mozilla/Thunderbird

Make sure "Use secure connection (SSL)" is selected in the Server Settings section of the "Account Settings" dialog.

You should also turn on TLS and authentication in the "Outgoing Server (SMTP)" section. This is required for all users.

 

 

Note that the specific "IMAP server directory:" setting may vary if you use other mail clients which store mail in, for instance, ~/Mail/.


Microsoft Outlook

Starting in Zimbra you will need to creat an Application Code which you will use later when prompted for a password.


Make sure "Let me set up my account manually" is checked in the Advanced Options tab of the mail server settings dialog.

  

Once this information is put in you should get a loading screen followed by a prompt for your CS email password here you will paste the Application Password instead of your normal CS password. After a moment you will be all set and have your CS account in Outlook.


Fetchmail

Fetchmail is fairly well documented at the fetchmail homepage. Specifically, the question of using SSL is covered in the FAQ.


Mac Mail.app

The setup section for Mail.app is awaiting screenshots.

The default "Drafts," "Sent," and "Trash" folders in the Mac Mail.app may not align properly with Zimbra immediately after adding the IMAP server to your Mac. The following instructions were taken from the Zimbra Wiki:

  • open Mail.app
  • click on the Trash folder under your Zimbra account
  • go to "Mailbox > Use this Mailbox for" and select Trash
  • do the same for Sent and Draft folders (unless they have been automatically mapped)
  • they will now appear below the Mail.app Trash, Sent, Draft folders along with the special folders from other accounts.
  • you will likely end up with new folders in the Zimbra section called 'Deleted Messages' and 'Sent Messages.'
  • you should delete these folders now (move any mail before you delete them)

iPhone

You may prefer to use the ActiveSync protocol instead of IMAP, as documented here.

  1. Launch the "Settings" application and select ""Mail, Contacts, Calendars"
  2. Select "Add Account..."
  3. Select "Other"
  4. Enter your full name and email address (including @cs.princeton.edu) in the appropriate fields
  5. Enter an Application Passcode obtained from Zimbra in the "Password" field
  6. Enter a "Description" such as "CS IMAP"
  7. Select "Save" in the upper-right corner of the screen
  8. Enter the "Incoming Mail Server" information:
    • Host Name: imap.cs.princeton.edu
    • User Name: your CS Unix username
    • Your pasword should already be filled in
  9. Enter the "Outgoing Mail Server" information:
  10. Select "Save" in the upper-right corner of the screen
  11. When the "Secure Connection Failed" alert box appears, select "Continue"
  12. When the second "Secure Connection Failed" alert box appears, select "Continue"
  13. When you are returned to the "Mail, Contacts, Calendars" settings page, basic setup is complete.

Similarly to Mail.app, the defaults for the "Drafts," "Sent," and "Trash" folders on the iPhone may not align properly with the Zimbra IMAP server. Use the following instructions to finish the configuration of your IMAP account:

  1. On the "Mail, Contacts, Calendars" settings page, select the IMAP account that you just added (eg "CS IMAP")
  2. Scroll down and select "Advanced"
  3. In the "Mailbox Behaviors" section, select "Sent Mailbox"
  4. Scroll down and select "Sent" in the "On the Server" section
  5. Touch "Advanced" in the upper-left corner of the screen
  6. Select "Deleted Mailbox"
  7. Scroll down and select "Trash" in the "On the Server" section
  8. Touch "Advanced" in the upper-left corner of the screen
  9. If desired, modify the "Removed" setting in a similar fashion to the above
  10. Exit the "Settings" application

Please NOTE:

When specifying what IMAP server to connect to, it is imperative that you enter "imap.cs.princeton.edu". (Not "mail.cs.princeton.edu", not "mail", and not "imap".) This is because when a client connects to the secure IMAP daemon, the certificate that is presented to it by the server identifies the server as "imap.cs.princeton.edu". If you connect to the secure IMAP server using a different alias, your mail client will complain that the certificate is not valid. This warning also applies to the SMTP server: you must specify the name as "smtp.cs.princeton.edu".

Tags: