Wiki source code of Jetty Installation
Last modified by Eleni Cojocariu on 2026/05/22 20:34
Hide last authors
| author | version | line-number | content |
|---|---|---|---|
 |
11.1 | 1 | There are several ways to run XWiki on Jetty: |
 |
21.3 | 2 | |
| 3 | * [[Installing a Standalone (Demo) Distribution>>documentation.xs.admin.installation.methods.install-standalone-demo-distribution.WebHome]]. which bundles Jetty and provide an all-in-one zip, ready to use. | ||
| |
11.1 | 4 | * Using the official [[Jetty docker image>>https://hub.docker.com/_/jetty]]. |
| |
18.1 | 5 | * [[Downloading and installing>>https://www.eclipse.org/jetty/download.html]] Jetty manually on your server. |
| |
11.1 | 6 | |
| |
12.1 | 7 | If you go with the last 2 options, make sure to: |
| |
21.3 | 8 | |
| |
12.1 | 9 | * Pick a [[supported version of Jetty>>dev:Community.SupportStrategy.ServletContainerSupportStrategy.WebHome]]. |
| 10 | * Follow the Jetty setup defined in the {{scm path="xwiki-platform-tools/xwiki-platform-tool-jetty/xwiki-platform-tool-jetty-resources/src/main/resources/jetty/modules/xwiki.mod"}}##xwiki.mod##{{/scm}} file used for the demo packaging. Note that the default setup used in the Jetty Docker image should work fine out of the box. | ||
| |
11.1 | 11 | |
| 12 | = Docker = | ||
| 13 | |||
| 14 | * Extract the [[XWiki WAR>>xwiki:Main.Download]] into a directory named ##xwiki##. Let's call this directory ##[XWIKI_HOME]##. | ||
| |
15.1 | 15 | * Setup a permanent directory on your local machine and let's call it ##[XWIKI_PERMDIR]## |
 |
22.1 | 16 | * Run the Jetty Docker image, for example: {{code language="none"}}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{{/code}} |
| |
19.1 | 17 | ** 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##. |
| |
17.1 | 18 | ** 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##. |
| |
22.1 | 19 | ** You'll need to specify what environment to execute in. |
| 20 | {{code language="none"}}docker run ... jetty:12 --module=--module=ee10-apache-jsp,ee10-deploy,ee10-websocket-jakarta{{/code}} | ||
| |
11.1 | 21 | |
| 22 | = Manual = | ||
| 23 | |||
| |
22.2 | 24 | See [[Configure Jetty>>documentation.xs.admin.installation.methods.install-xwiki-war.configure-servlet-container.configure-jetty.WebHome]]. |
 |
8.1 | 25 | |
| |
11.1 | 26 | = Troubleshooting = |
| |
8.1 | 27 | |
| |
11.1 | 28 | == Unable to parse form content == |
| |
8.1 | 29 | |
| |
22.3 | 30 | See [[Unable to Parse Form Content in Jetty>>documentation.xs.admin.installation.methods.install-xwiki-war.configure-servlet-container.configure-jetty.unable-parse-form-content-jetty.WebHome]]. |
