There are lots of Java versions out there and supporting all of them is just too hard to be done in a quality manner. Thus we only support a subset.

By "supported versions" we mean:

  • XWiki runs fine on that Java version.
  • Issues created for these versions of Java in JIRA are not closed as won't fix and we make a best effort to fix them.
  • We include these versions in our tests (be them automated or manual).

Supported Java Versions

  • Always support the current Java LTS as defined by Oracle. Specifically this means working actively to make XWiki work on it as soon as it’s available.
    • e.g. in Jan 2020, the current Java LTS is Java 11. Java 17 will become the new LTS in 2021.
    • We've noticed several issues with Java 17 that we're working on fixing. We currently recommend using Java 11 till they are fixed:

      However, you can get XWiki to run on Java 17 by passing the following JVM parameters (they are automatically passed when using the Standalone packaging start scripts on linux):

      --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/ --add-opens java.base/java.util=ALL-UNNAMED --add-opens java.base/java.util.concurrent=ALL-UNNAMED
  • Keep supporting the previous LTS of Java too.
    • e.g. in Jan 2020, the previous LTS is Java 8. When java 17 is out, and when XWiki is confirmed to work with Java 17, then we will support Java 11 and Java 17, and thus drop support for Java 8.


  • Java LTS cycle are every 3 years so that seems a good cadence for us to move Java versions too.
  • We support the previous LTS since we want to be "business"-friendly and know that businesses take some time to upgrade.

By XWiki Versions

XWiki VersionsJava Version supportedSource Level
XWiki < 6.0Java 6Java 6
XWiki < 8.1Java 7Java 7
XWiki < 11.3Java 8Java 8
XWiki >= 11.3Java 8 & Java 11Java 8
XWiki >= 14.0Java 11Java 11
Created by Vincent Massol on 2020/01/06 14:13

Get Connected