There are several ways to run XWiki on Jetty:

• Installing a Standalone (Demo) Distribution. which bundles Jetty and provide an all-in-one zip, ready to use.
• Using the official Jetty docker image.
• Downloading and installing Jetty manually on your server.

If you go with the last 2 options, make sure to:

• Pick a supported version of Jetty.
• Follow the Jetty setup defined in the xwiki.mod file used for the demo packaging. Note that the default setup used in the Jetty Docker image should work fine out of the box.

Docker

• Extract the XWiki WAR into a directory named xwiki. Let's call this directory [XWIKI_HOME].
• Setup a permanent directory on your local machine and let's call it [XWIKI_PERMDIR]
• Run the Jetty Docker image, for example: docker run -v [XWIKI_HOME]:/var/lib/jetty/webapps/xwiki -v [XWIKI_PERMDIR]:/var/lib/jetty/xwiki-data -p 8080:8080 jetty:12-jre21 -Dxwiki.data.dir=/var/lib/jetty/xwiki-data
  • Note that you won't need the -Dxwiki.data.dir=/var/lib/jetty/xwiki-data part if you have edited [XWIKI_HOME]/WEB-INF/xwiki.properties and set the environment.permanentDirectory to point to /var/lib/jetty/xwiki-data. The system property just overrides whatever is defined in environment.permanentDirectory.
  • Also note that you'll need a database set up too. If you want to quickly test it, you can simply copy the the HSQLDB JAR into WEB-INF/lib.
  • You'll need to specify what environment to execute in.
    docker run ... jetty:12 --module=--module=ee10-apache-jsp,ee10-deploy,ee10-websocket-jakarta

Manual

See Configure Jetty.

Troubleshooting

Unable to parse form content

See Unable to Parse Form Content in Jetty.