Configuring Jira applications to receive email from a POP or IMAP mail server
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
- In the upper-right corner of the screen, select Administration
> System. - Select Mail > Incoming Mail to open the Incoming Mail page.
- 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.
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.comorimap.yourcompany.comPOP / 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.
- 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.
- Click the Test Connection to check that Jira can communicate with the mail server you just configured.
- 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.