'javax.mail.MessagingException 501 Syntax HELO hostname' Due to Server Host Name
Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.
Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
Symptoms
JIRA fails to send an email message stating:
1
2
3
4
Attempted test email send. Log shows the following (this is the top of the output):
com.atlassian.mail.MailException: javax.mail.MessagingException: 501 Syntax: HELO hostname
....
Cause
The server's hostname is not set. JIRA is sending the server's IP address instead.
Resolution
Resolutions include:
Refer to your system's documentation to set the hostname correctly.
Alternatively, add an entry in
/etc/hosts.If this doesn't work, pass the hostname to JIRA specifically.
See Problems Sending Email from JIRA - EHLO requires domain address for details.
Was this helpful?