Domino & Notes error

SMTPClient: SSL handshake error [code]

Also seen as: Router: No messages transferred to [domain] (host [host]) via SMTP: SSL IO error

The error code varies.

What it means

Domino could not complete the TLS handshake with the remote mail server when sending outbound mail.

Common causes

  • No common TLS version or cipher between the two servers
  • Old ciphers still enabled on the Domino server
  • A missing or wrongly named outgoing key file or certificate

Quick fixes

  1. Review the TLS cipher settings for the server and remove deprecated ciphers
  2. Check the outgoing key file or certificate settings are correct
  3. Run tell router update config after changes
  4. Keep Domino on a current release so it supports modern TLS

Need a hand with this?

Paste your exact message into What's That Error? for a plain-English explanation, or get in touch. I've been supporting Domino and Notes for 28 years.

Disclaimer

The errors, causes and fixes on this site are carefully researched, drawing on HCL documentation and 28 years of hands-on Domino and Notes experience. Every environment is different, though, and a solution that works in one may not be right for yours. Exact wording can also vary between Domino and Notes versions.

This information is general guidance only and is provided without warranty of any kind. Always back up your data and test changes on a non-production system first. To the extent permitted by law, Bruinsma Services Pty Ltd accepts no responsibility or liability for any loss, damage, downtime or other consequence arising from use of this information. For advice specific to your environment, please contact me.