Link Search Menu Expand Document


This section describes how to run the KEEP APIs against your local copy of Notes Domino.

Install the KEEP jar file

First create a keep folder under the Notes Data directory (for example: c:\Notes\data\keep)

Next find a version of the project KEEP jar, projectkeep.jar.

Configure KEEP

Once the jar file is in place, you will need to configure two environment variables:

Add a new variable called DYLD_LIBRARY_PATH and point it to your Notes root directory (for example: c:\Notes).


Next under System variables, edit the Path variable and add a new entry pointing your Notes root directory (for example: c:\Notes).

Update Path


  1. Get the file “demo.nsf” from the Downloads and copy it to your Notes data folder (for example: c:\notes\data).

  2. Next get the file windows_run_keep.cmd from the domino-keep repo TODO Link and copy it to your new KEEP folder (for example c:\Notes\data\keep)

  3. Edit windows_run_keep.bat and set GodMode to true (SET GodMode=true) which will skip calling the Notes createsession code. If set to false, the createsession call will fail since Notes is not a server.

  4. Now you’re ready to start KEEP by double-clicking on windows_run_keep.bat in Windows Explorer or by opening a Command window and executing it from your KEEP directory.

Configure a test user

  1. If you haven’t run KEEP yet, do that now (step 4 above). Running KEEP will create the KEEP Configuration (KeepConfig.nsf) if it doesn’t already exist.

  2. Open KeepConfig.nsf with your Notes client:

Keep Config

  1. Now select the user John Doe and click the Set available button at the top of the screen. This will ensure that the user is available for testing.

John Doe

Validate your installation

  1. Run Swagger against your KEEP installation.
  2. Assuming everything has been set up correctly, you should see the KEEP APIs and be able to run them.