Domino & Notes error

Management server failed to launch on 0.0.0.0:8889

Also seen as: Fatal java.net.BindException: Address already in use

Domino REST API (Project KEEP) start-up error. 8889 is the default management port; the number shown matches your configuration.

What it means

The Domino REST API could not open its management port because another process is already listening on it, so the REST API task does not start properly.

Common causes

  • A previous REST API process did not shut down and still holds the port
  • The REST API was started twice, for example from the console and from a script
  • Another application on the server is using the same port

Quick fixes

  1. Find the process using the port (for example netstat -ano on Windows or ss -ltnp on Linux)
  2. If it is a leftover REST API Java process, stop it, then load restapi from the console
  3. If another product owns the port, move one of them to a different port in the REST API configuration
  4. Check the console afterwards to confirm the REST API started cleanly

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.