Configure Jetty for XWiki in Docker

Last modified by Eleni Cojocariu on 2026/06/19 16:23

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. 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.
  4. 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
  5. 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
  6. Once the container is running, open http://localhost:8080/xwiki in your browser to continue with the distribution wizard.

Related

Get Connected