Install XWiki .war Package Manually
Last modified by Eleni Cojocariu on 2026/08/13 09:53
Steps
To install XWiki from the .war package into a servlet container you manage yourself:
- Check that your system meets the prerequisites.
- Install and configure a servlet container.
- Configure the permanent directory.
- Install and configure a relational database.
- Install the XWiki UI.
- Open your wiki in a browser. XWiki serves its Home page once the UI is installed.
FAQ
Which servlet container and database should I choose?
Tomcat and Jetty are the two officially supported servlet containers. HSQLDB, MariaDB, MySQL, PostgreSQL and Oracle are the officially supported databases; HSQLDB is meant for evaluation rather than production.
Do I need to install a database before deploying the WAR?
Yes. XWiki initializes and connects to its database as soon as the servlet container deploys the web application, so a database that is not reachable makes the first start fail.
Is there a quicker way to try XWiki out?
Yes. The standalone (demo) distribution bundles Jetty and HSQLDB and needs no configuration.
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 a Servlet Container
- To configure the XWiki WAR package manually it is mandatory to configure a servlet container.
- Install and Configure a Relational Database
- To configure the XWiki WAR package manually it is mandatory to configure a relational database.