Install XWiki .war Package Manually
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.
- Open your wiki in a browser and install the flavor using the Distribution Wizard, which fills the empty wiki with its Pages.
- XWiki serves its Home page once the flavor 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. Either try XWiki in Cloud (no installation needed), or install the standalone (demo) distribution that 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.
- Configure Jetty
- Steps to deploy and run the XWiki WAR on the Jetty servlet container, a lightweight and embeddable Java web server.
- Configure Tomcat
- Steps to deploy and run the XWiki WAR on Apache Tomcat, one of the most widely used Java servlet containers.
- Install and Configure a Relational Database
- To configure the XWiki WAR package manually it is mandatory to configure a relational database.
- Configure HSQLDB
- ow to set up the embedded HSQLDB database, which is mainly suitable for evaluation and testing rather than production use.
- Configure MySQL
- How to create the database and user, and configure XWiki to use MySQL as its storage backend.
- Configure MariaDB
- How to create the database and user, and configure XWiki to use MariaDB, a MySQL-compatible database.
- Configure PostgreSQL
- How to manually create the database and user, and configure XWiki to use PostgreSQL.
- Configure Oracle
- How to manually create the schema and user, and configure XWiki to use an Oracle database.
