Configuring Jira applications to receive email from a POP or IMAP mail server

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

To enable Jira to create comments and issues from email, you need to first configure Jira to receive email from a POP or IMAP mail server as described below.

Note: For all of the following procedures, you must be logged in as a user with the Jira Administrators global permission.

Add or edit a POP or IMAP mail server

  1. In the upper-right corner of the screen, select Administration  > System
  2. Select Mail > Incoming Mail to open the Incoming Mail page.
  3. Click either the Add mail server button to define a new mail server, or the Edit link at the right of an existing mail server configuration, which will open the Add/Update Mail server page.
  4. Complete the fields on this page as follows:

    Name

    Specify a short, arbitrary name to identify your mail server configuration. You could possibly just specify the email address of the POP / IMAP mail server.

    Description

    (Optional) Specify an arbitrary description that describes the POP or IMAP mail server configuration and/or what it is used for. For example, 'Email Issue Creation/Comments for <Project>'. This description appears below the Name of the POP / IMAP mail server in the Mail servers table.

    Service Provider
    (not available when updating an existing POP / IMAP mail server)

    Choose between using your own POP / IMAP mail server (i.e. Custom), Gmail POP / IMAP (i.e. Google Apps Mail / Gmail [POP3 / IMAP]) or Yahoo! POP (i.e. Yahoo! MailPlus) as the service provider for your POP / IMAP mail server.

    If you use a Microsoft mail server, select Custom.

    If you choose any of the Gmail or Yahoo! options and then switch back to Custom, some of the key fields in this section will automatically be populated with the relevant POP / IMAP mail server settings for these service providers.

    Protocol

    Choose between whether your POP / IMAP mail server is a standard (i.e. POP or IMAP) or a secure (i.e. SECURE_POP or SECURE_IMAP) one. If you want to use an OAuth 2.0 integration as your Authentication method, select a secure email server.

    Jira Cloud does not support self-signed certificates.

    Host Name

    Specify the hostname or IP address of your POP / IMAP mail server. Eg. pop.yourcompany.com or imap.yourcompany.com

    POP / IMAP port

    (Optional) The port to use to retrieve mail from your POP / IMAP account. Leave blank for default.
    The defaults are the following: POP: 110; SECURE_POP: 995; IMAP: 143; SECURE_IMAP: 993.

    Timeout

    (Optional) Specify the timeout period in milliseconds, which is treated as 10000 if this field is left blank. Specifying 0 or a negative value here will result in Jira waiting indefinitely for the POP / IMAP server to respond.

    Username

    The username used to authenticate your POP / IMAP account.

    Authentication method

    The way to authenticate to the mail server. If you have configured your OAuth 2.0 integration, it will show on the list to select.

    Password

    Google and Microsoft are planning to disable using password as an authentication method. Once this method is disabled, you will not be able to connect to your Gmail or Microsoft Exchange Online. Configure OAuth 2.0 integration and select it as your authentication method to be able to add comments and create issues from email. Learn more about OAuth 2.0 integration.

    The password for your POP / IMAP account. You can still use it for a Yahoo or your custom email server.

    When editing an existing POP / IMAP mail server, select the Change Password checkbox to access and change this field.

  5. Click Authorize. You will be redirected to your service provider's site to log in to your account and authorize the connection. When you do, you will be redirected back to the application. 
  6. Click the Test Connection to check that Jira can communicate with the mail server you just configured.
  7. Click Save.

POP / IMAP over SSL

You can encrypt email communications between Jira and your mail server via SSL, provided your mail server supports SSL. 

Firstly, you will need to import the mail server certificate into a Java keystore. The process is described on the Connecting to SSL Services page.

If you have a self-signed certificate, you should import it so that Jira can communicate with your mail server.



Last modified on Dec 13, 2022

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.