Domino & Notes error

AllocHandle: OUT OF PRIVATE HANDLES!

Often accompanied by generic insufficient memory errors, and can lead to crashes such as 'PANIC: *** Private HANDLE table full.'

What it means

A Domino process has used up its allowance of private memory handles, usually because something keeps allocating memory without freeing it.

Common causes

  • A memory or handle leak in an agent, servlet or add-in task
  • Java code that loops through many documents or view entries without calling recycle()
  • Older releases with lower handle limits (raised from Domino 8.5.3, and higher again on 64-bit)

Quick fixes

  1. Note which task reports the warning on the console, and run nsd -detach twice a couple of minutes apart while it is happening
  2. Restart the affected task (for example restart task http) or the server to recover
  3. Track down the agent or code running at the time and make sure Java objects are recycled
  4. Move to a current 64-bit Domino release

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.