Install XWiki .war Package Manually

Last modified by Eleni Cojocariu on 2026/08/13 09:53

Steps

Warning

WIP: documentation of this topic is being refactored. For full documentation please refer to Installing XWiki .war package manually.

To install XWiki from the .war package into a servlet container you manage yourself:

  1. Check that your system meets the prerequisites.
  2. Install and configure a servlet container.
  3. Configure the permanent directory.
  4. Install and configure a relational database.
  5. Install the XWiki UI.
  6. 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.

Related

Get Connected