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>