Troubleshooting

If you experience problems with the Jackrabbit JCR server, please check the following:

  1. Did you encounter an exception? Copy the exception stack trace somewhere so you don't loose it. The stack trace contains valuable information for the Jackrabbit developers if you need to file a bug report for the problem you encountered.
  2. Is the repository up and running? Try browsing the default workspace to check if you can still see any content in the repository. You will see an error message if the repository is not available.
  3. What were you trying to do? Try to verify that your client code or other manner of repository use is correct. Did it work before or are you trying to do something new?
  4. Are there any notable log entries? Check the log files for any related warnings or errors. By default the Jackrabbit JCR Server writes log entries to the standard output of the servlet container. You can customize logging by editing the /WEB-INF/log4j.xml file and redeploying this web application.

If none of the above steps help you identify or resolve the problem, you can contact the Jackrabbit users mailing list or report the problem in the Jackrabbit issue tracker to get support from the Jackrabbit community. When contacting the community, please include any relevant details related to the above questions and the environment information shown at the end of this page.

Jackrabbit mailing list

The Jackrabbit user mailing list, users@jackrabbit.apache.org, is the place to discuss any problems or other issues regarding the use of Apache Jackrabbit (or JCR content repositories in general).

Feel free to subscribe the mailing list or browse the archives listed as described in the Jackrabbit mailing lists page.

Jackrabbit issue tracker

If you think you've identified a defect in Jackrabbit, you're welcome to file a bug report in the Jackrabbit issue tracker. You can also use the issue tracker to request new features and other improvements.

You need an account in the issue tracker to report new issues or to comment on existing. Use the registration form if you don't already have an account. No account is needed browsing and searching existing issues.

Environment information

This instance of the Jackrabbit JCR Server is running in a jetty/9.4.53.v20231009 servlet container that supports the Java Servlet API version 3.1.

Details of the Java and operating system environment are included in the system properties shown below: 

-- listing properties --
awt.toolkit=sun.awt.X11.XToolkit
java.specification.version=11
jetty.log=/home/hdd/jackrabbit/log/jetty.log
sun.cpu.isalist=
sun.jnu.encoding=UTF-8
java.class.path=/home/jackrabbit/jackrabbit-standalon...
java.vm.vendor=Ubuntu
sun.arch.data.model=64
java.vendor.url=https://ubuntu.com/
user.timezone=Etc/UTC
os.name=Linux
java.vm.specification.version=11
log.level=INFO
sun.java.launcher=SUN_STANDARD
user.country=US
sun.boot.library.path=/usr/lib/jvm/java-11-openjdk-amd64/lib
sun.java.command=/home/jackrabbit/jackrabbit-standalon...
jdk.debug=release
sun.cpu.endian=little
user.home=/home/jackrabbit
org.apache.jackrabbit.core.util.RepositoryLock:/home/hdd/jackrabbit=org.apache.jackrabbit.core.util.Repos...
user.language=en
java.specification.vendor=Oracle Corporation
java.version.date=2025-07-15
java.home=/usr/lib/jvm/java-11-openjdk-amd64
file.separator=/
java.vm.compressedOopsMode=Zero based
line.separator=

java.specification.name=Java Platform API Specification
java.vm.specification.vendor=Oracle Corporation
derby.stream.error.file=/home/hdd/jackrabbit/log/derby.log
java.awt.graphicsenv=sun.awt.X11GraphicsEnvironment
sun.management.compiler=HotSpot 64-Bit Tiered Compilers
java.runtime.version=11.0.28+6-post-Ubuntu-1ubuntu124.04.1
user.name=jackrabbit
path.separator=:
os.version=6.8.0-79-generic
java.runtime.name=OpenJDK Runtime Environment
file.encoding=UTF-8
java.vm.name=OpenJDK 64-Bit Server VM
java.vendor.url.bug=https://bugs.launchpad.net/ubuntu/+so...
jetty.git.hash=27bde00a0b95a1d5bbee0eae7984f891d2d0f8c9
java.io.tmpdir=/tmp
java.version=11.0.28
user.dir=/home
os.arch=amd64
java.vm.specification.name=Java Virtual Machine Specification
java.awt.printerjob=sun.print.PSPrinterJob
jackrabbit.log=/home/hdd/jackrabbit/log/jackrabbit.log
sun.os.patch.level=unknown
java.library.path=/usr/java/packages/lib:/usr/lib/x86_6...
java.vm.info=mixed mode, sharing
java.vendor=Ubuntu
java.vm.version=11.0.28+6-post-Ubuntu-1ubuntu124.04.1
java.specification.maintenance.version=3
sun.io.unicode.encoding=UnicodeLittle
java.class.version=55.0