Problems Sending Email from JIRA - EHLO requires domain address

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

Email are not being sent from JIRA configured for SMTP. Errors appear such as:

1 2 3 4 EHLO 501 5.0.0 EHLO requires domain address HELO 501 5.0.0 HELO requires domain address

Cause

JIRA is not sending the correct parameter to to the outgoing mail server when attempting to send a message. Instead of sending its domain name, it is sending nothing.

Resolution

When you start JIRA, pass it the following parameter:

1 -Dmail.smtp.localhost=<computer_name>

ℹ️ Substitute the JIRA server name for <computer_name>. See Setting Properties and Options on Startup.

Updated on April 8, 2025

Still need help?

The Atlassian Community is here for you.