Configure Jetty for XWiki in Docker

Last modified by Eleni Cojocariu on 2026/05/28 16:37

Steps

Warning

WIP

  1. Download and then extract the XWiki WAR into a directory named xwiki and call it [XWIKI_HOME].
  2. Create a permanent data directory on your host machine and call it [XWIKI_PERMDIR].
  3. Run the Jetty Docker container and mount both directories:
    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
  4. Optionally remove -Dxwiki.data.dir=/var/lib/jetty/xwiki-data if you configure the permanent directory in XWiki instead:
    [XWIKI_HOME]/WEB-INF/xwiki.properties
    environment.permanentDirectory=/var/lib/jetty/xwiki-data
  5. Ensure a database is available for XWiki. For quick testing, you can copy the HSQLDB JDBC JAR into WEB-INF/lib.
  6. Start Jetty with the required modules enabled:
    docker run
    ...
    jetty:12-jre21
    --module=ee10-apache-jsp,ee10-deploy,ee10-websocket-jakarta

Related

Get Connected