JIRA Documentation

JIRA 6.4.x
JIRA 6.0 Documentation
JIRA 5.2 Documentation
JIRA 5.1 Documentation
More...
 

 

Search the Knowledge Base and Documentation Spaces

You're visiting the JIRA Knowledge Base. Visit the JIRA Knowledge Base Home for an overview.

Skip to end of metadata
Go to start of metadata

Symptoms

JIRA is unable to retrieve messages from an IMAP server and displays error messages like the following in the logs:

Cause

The Java mail library used by JIRA is not configured to use TLS for non-SSL connections by default. If you connect to an IMAP server without using SSL, and the server is not configured to allow unencrypted connections, you may see the error shown above.

Resolution

There are different ways to resolve this problem:

(warning) If following options 1 or 2 below, please follow the steps on Connecting to SSL services to import the Certificate from the IMAP server in order for the connection to work correctly.

Option 1:
Switch to using an SSL connection to communicate with your IMAP server.

Option 2:
If you are connecting to your IMAP server over a non-SSL connection (using STARTTLS), set the following property to the JIRA Startup Options:

-Dmail.imap.starttls.enable=true

Option 3:
Allow unencrypted communications between your JIRA instance and your IMAP server (not recommended).

Help us improve!
Is this article helpful?
Is it well written?
Is the content complete?