Configure a Servlet Container
Last modified by Eleni Cojocariu on 2026/08/13 15:09
Steps
To deploy the XWiki WAR into a servlet container:
- Install a supported servlet container.
- Download the XWiki WAR package corresponding to the version you want to install.
- Copy or extract the XWiki WAR package into the servlet container's deployment directory.
- Configure the XWiki permanent directory.
- Copy any additional required JDBC drivers or libraries into the servlet container, or into the XWiki web application's WEB-INF/lib directory.
- Configure the servlet container for your environment: memory settings, ports, HTTPS, context path and security settings.
- Start the servlet container. XWiki is deployed and answers on the container's HTTP port.
Community-contributed instructions exist for containers that are not officially supported, and that receive no guaranteed testing:
FAQ
Which servlet containers are officially supported?
Tomcat and Jetty, at the versions listed in the Servlet Container Support Strategy. Other containers may work but are not tested.
Can I deploy XWiki under a context path other than /xwiki?
Yes, by naming the deployment directory accordingly. Set the same path in the xwiki.webapppath property of xwiki.cfg so that XWiki generates its URLs correctly.
More
To find more about the current topic, you can search, select an highlighted topic, or use the table below and filter the columns to narrow your choices.
- Configure Tomcat
- Install and set up Tomcat as the servlet container running XWiki.
- Configure Jetty
- Install and set up Jetty as the servlet container running XWiki.
- Configure Tomcat for XWiki in Docker
- Customize the Tomcat configuration used by the XWiki Docker image.
- Configure Jetty for XWiki in Docker
- Run XWiki on the official Jetty Docker image.
- Java Memory for Tomcat
- Understand the Out Of Memory errors and how much memory Tomcat needs.
- Tomcat Troubleshooting
- Solve the common warnings, errors and configuration issues met on Tomcat.
