Domino & Notes error

HTTP Server: SSL handshake failure, IP address [ip], Keyring [file], [SSL Error: Keyring file not found], code [4164]

Also seen as: HTTP Server: SSL handshake failure, IP address [ip], Keyring [file], [SSL Error: Keyring File access error], code [4169]

Applies to servers that use .kyr keyring files (Domino 11 and earlier, or 12 and later still using keyring files instead of CertMgr).

What it means

An HTTPS connection failed because the HTTP task could not find, or could not read, the keyring file named in its configuration.

Common causes

  • The keyring file name in the Server document or Internet Site document does not match the real file
  • The .kyr and .sth files are not together in the expected folder, usually the data directory
  • File system permissions stop the server from reading the files, or the files are damaged

Quick fixes

  1. Check the key file name field for the SSL port or Internet Site and compare it with the actual file name
  2. Keep the .kyr and matching .sth file together in the data directory and make sure the server account can read them
  3. Restore the pair from a backup, or move to CertMgr and certstore.nsf on Domino 12 or later

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.