"Error Occurred with Mail Service" on SMTP Set-Up

Published Date: June 24, 2025

Products and Versions Covered: 

• Jama Connect®
  • Self-hosted, Replicated - KOTS

Summary

When setting up "Outgoing Mail (SMTP)" in Self-Hosted Jama Connect instances, saving the settings results in the message "Error Occurred with Mail Service".

Resolution

If not needed, you can just uncheck the 'Is TLS enabled' button and save the configuration.

A mismatch between TLS certificates can cause this. If your mail service does not require a certificate, you can disable it. In the contour.log, you will see errors such as:

org.springframework.mail.MailSendException: Mail server connection failed. Failed messages: jakarta.mail.MessagingException: Could not convert socket to TLS;
nested exception is:
 javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
...
Caused by: javax.net.ssl.SSLHandshakeException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
 at java.base/sun.security.ssl.Alert.createSSLException(Alert.java:131)

This indicates that a certificate is needed, since the check mark is checked.

To prevent this, you can confirm whether your mail service requires TLS and match the settings in the "Outgoing Mail (SMTP)" section. If it does, add the certificate in the KOTS Admin Config under "Trusted Certificates".

Additional Resources

• Success Programs
• Success Catalog
• Datasheets
• Request a Solution Offering or Training from the Success Catalog

Feedback:
We welcome your input! Please sign in to leave any comments, suggestions, or ideas for improvement below.