Compatibility Considerations

See Database support strategy for the supported versions.

MariaDB versions older than 10.2

Since XWiki moved to utf8mb4 by default it does not work with versions of MariaDB lower than 10.2 out of the box because of a limitation in the default maximum size of the keys and the default row format.

Installation Steps

In general you should follow the instructions for installing MySQL since MariaDB is supposed to be a drop-in replacment for MySQL.

Here are the differences with the MySQL installation:

• Download and install MariaDB, using a supported version
• You need to have the MariaDB JDBC Driver JAR (named mariadb-java-client-*.jar) installed in XWiki's WAR file. If this file isn't present in XWiki's WEB-INF/lib directory you'll need to download it and copy it there. You can download it from the MariaDB Connector/J Driver page or directly from the Maven Central Repository.
• You need to tell XWiki to use MariaDB. To do this, edit the WEB-INF/hibernate.cfg.xml file where you have expanded the XWiki WAR file and replace the matching properties with the following ones:
  <property name="connection.url">jdbc:mariadb://localhost/xwiki?useSSL=false</property>
  <property name="connection.username">xwiki</property>
  <property name="connection.password">xwiki</property>
  <property name="connection.driver_class">org.mariadb.jdbc.Driver</property>
  <property name="connection.useUnicode">true</property>
  <property name="connection.characterEncoding">UTF-8</property>