Servlet Container Support Strategy

Last modified by Thomas Mortagne on 2025/01/22 15:25

There are a lot of Servlet Containers out there and supporting all of them in all versions is just too hard to be done in a quality manner.

By "supporting" we mean:

  • Issues created for these Servlet Containers in JIRA are not closed as won't fix and we make a best effort to fix them.
  • We try as much as possible to include these Servlet Containers in our tests (be them automated or manual).
  • When we create new features or modify existing features we make a best effort to verify that they work on the supported list of Servlet Containers.
  • The complete and precise list of supported Servlet Containers in a given XWiki release is indicated in the Release Notes for that release (starting with XWiki 10.7).

Supported Servlet Containers

XWiki 16.10.x is stuck with Jakarta EE 8 application servers (Tomcat 9 and Jetty 10/12 EE 8) because more recent application servers moved to the jakarta namespace. So what's indicated below only applies to XWiki 17+.

Servlet ContainerVersionsReason for supporting itInstallation Instructions

tomcat-icon.png
Tomcat

Latest + LTS version strategy. Currently tested:

  • XWiki 17+ (jakarta): latest of 11.x and 10.x
  • XWiki < 17 (javax): latest of 9.x
Biggest market share of Servlet Containers and most used by XWiki usersInstructions

jetty-icon.png
Jetty
(XWiki Standalone packaging)

Latest of 12.xProvided as a packaging in the XWiki Standalone distributionInstructions

jetty-icon.png
Jetty
(Official packaging)

Latest + LTS version strategy. Currently tested: latest of 12.x.Second most used Container by XWiki usersInstructions

Servlet Containers that are not supported

The following list of Servlet Containers are not officially supported, even though we have installation instructions for them, contributed by the community. XWiki may work with them, completely or partly. We don't constantly test against them, we don't ensure that new features work on them. However whenever someone raises an issue on JIRA about them and it's easy to fix (or if someone provides a patch) then we fix it.

Servlet ContainerInstallation Instructions
Instructions
Instructions

For a larger list, see the Wikipedia page on web container.

Get Connected