Configure Jetty for XWiki in Docker
Last modified by Eleni Cojocariu on 2026/06/19 16:23
Steps
- Download and then extract the XWiki WAR into a directory named xwiki and call it [XWIKI_HOME].
- Create a permanent data directory on your host machine and call it [XWIKI_PERMDIR].
- Ensure a database is available for XWiki. You can install and configure a relational database or, for quick testing, you can copy the HSQLDB JDBC JAR into [XWIKI_HOME]WEB-INF/lib.
- Run the Jetty Docker container and mount both directories and enabling the required modules:
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 --module=ee10-apache-jsp,ee10-deploy,ee10-websocket-jakarta - You can omit -Dxwiki.data.dir=/var/lib/jetty/xwiki-data from the command above if you instead set the permanent directory directly in XWiki's configuration:
[XWIKI_HOME]/WEB-INF/xwiki.properties environment.permanentDirectory=/var/lib/jetty/xwiki-data - Once the container is running, open
http://localhost:8080/xwikiin your browser to continue with the distribution wizard.