groovy-shell-server embedded in XPages apps
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

XPages Groovy Shell

This project is an implementation of Groovysh Server that runs inside of an XPages application, using its ClassLoader.


Enable the org.openntf.xsp.groovyshell.library library in your application and then add the org.openntf.xsp.groovyshell.port property to your Xsp Properties file, with the value of a port that is open on the server.


  • Domino 9.0.1 Feature Pack 8 or above

Known Issues

  • There is currently no authentication mechanism, so this is horrifically insecure, even by my standards.
  • The shell session doesn't really interact with the running Faces context, and so doesn't have access to the managed beans or other contextual information.
  • The survival of the server is dependent on the survival of the XPages application and does nothing to extend it.
  • There are some minor server-crash-related issues.
    • This is presumably due to the hijacking of normal thread and NotesContext behavior.
  • Intermittently, the server will end a session with a "Bad packet length" message and refuse to accept new connections until an HTTP restart.


  • Add authentication, perhaps referencing the database's ACL to allow Designers and above, or requiring a special role.
  • Consider investigating loading the servers at HTTP start instead of tying it to an ApplicationListener.


The XPages Groovy shell is licensed under the Apache License 2.0.