Start/notes.ini Parameters/JavaUserClasses

JavaUserClasses

🛠️
Parameter: JavaUserClasses
Short description: Extends the class path of the Domino / Notes JVM – e.g. for custom JARs, JDBC drivers, or JNI bindings that Java agents should be able to reach.

Profile

Parameter
JavaUserClasses
Category
Client configuration
Component
Server, Client
Available since
6.0
Supported versions
9.0.1, 10.0, 11.0, 12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
Path specification with platform-specific separator (Windows: ;, Linux/AIX: :)

Description

JavaUserClasses extends the standard class path of the Domino / Notes JVM with additional JARs and directories. This allows JDBC drivers, REST/JSON libraries, or custom helper classes to be used in Java agents and XPages without embedding them in the database. On the server, the path applies system-wide; in the Notes Client, it takes effect when local Java agents run.

Example configuration

JavaUserClasses=C:\\domino\\jvm\\extlib\\postgresql.jar;C:\\domino\\jvm\\extlib\\custom\\

Notes & pitfalls

  • Separator depends on the platform: ; on Windows, : on Linux / AIX.
  • Changes require a server or client restart – a simple tell http restart is usually not enough.
  • JARs should be readable by the Domino service account and ideally read-only.
  • For OSGi / XPages components, prefer dedicated OSGi update sites instead of dropping them here.
  • Version conflicts with bundled JARs (e.g. JSON, Apache Commons) can be hard to debug – verify compatibility beforehand.