Sending mails from JIRA fails: Need fully-qualified hostname


I am using a SMTP server in our university that requires mail clients to include the fully-qualified hostname in HELO reqeusts. Apparently, JIRA sends only a short hostname. Can I configure JIRA to use a fully-qualified hostname?

Running "hostname -f" on the JIRA server gives me the full hostname by the way.


An error has occurred with sending the test email:
com.atlassian.mail.MailException: javax.mail.SendFailedException: Invalid Addresses;
  nested exception is:
    com.sun.mail.smtp.SMTPAddressFailedException: 504 5.5.2 <>:
 Helo command rejected: need fully-qualified hostname

1 answer

In some configurations java might not be able to get the FQDN, you can try running this code to see what it returns.

InetAddress localHost = InetAddress.getLocalHost();

JIRA uses javamail to send email. I didn't check this but it should be possible to use this property to set the name with a system property upon JIRA startup.

mail.smtp.localhostStringLocal host name. Defaults to InetAddress.getLocalHost().getHostName(). Should not normally need to be set if your JDK and your name service are configured properly.

Suggest an answer

Log in or Join to answer
Community showcase
Sarah Schuster
Posted Jan 29, 2018 in Jira

What are common themes you've seen across successful & failed Jira Software implementations?

Hey everyone! My name is Sarah Schuster, and I'm a Customer Success Manager in Atlassian specializing in Jira Software Cloud. Over the next few weeks I will be posting discussion topics (8 total) to ...

3,147 views 13 19
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot