Install and Configure a Relational Database

Last modified by Eleni Cojocariu on 2026/05/20 16:51

Content

Steps

Warning

WIP: documentation of this topic is being refactored. For full documentation please refer to IInstall and configure a Relational Database.

To install and configure a relational database, follow this general strategy: 

  1. Install a supported relational database management system.
  2. Create a XWiki database.
  3. Create a user with all privileges on that database.
  4. Copy your JDBC driver for your database into the XWiki web application's WEB-INF/lib directory directory.
  5. Configure XWiki to use the created database. This involves modifying the WEB-INF/hibernate.cfg.xml file as is described in the documentation for each database.
  6. Start XWiki. It will automatically create the various tables it needs when it executes on the first run.
  7. Add the missing indexes manually.

You can follow the database-specific documentation for:

More

To find more about the current topic, you can search or use the table below and filter the columns to narrow your choices.

Get Connected