Show last authors
1 = Compatibility Considerations =
3 See [[Database support strategy>>dev:Community.DatabaseSupportStrategy]] for the supported versions.
5 == MariaDB versions older than 10.2 ==
7 If you use utf8mb4 encoding you won't be able to use version of MariaDB older than 10.2 out of the box because of a limitation in the default maximum size of the keys and the default row format.
9 = Installation Steps =
11 In general you should follow the instructions for [[installing MySQL>>InstallationMySQL]] since MariaDB is supposed to be a drop-in replacement for MySQL.
13 Here are the differences with the MySQL installation:
15 * Download and install [[MariaDB>>]], using a [[supported version>>dev:Community.DatabaseSupportStrategy]]
16 * 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>>]].
17 * 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:(((
18 {{code language="xml"}}
19 <property name="connection.url">jdbc:mariadb://localhost/xwiki?useSSL=false</property>
20 <property name="connection.username">xwiki</property>
21 <property name="connection.password">xwiki</property>
22 <property name="connection.driver_class">org.mariadb.jdbc.Driver</property>
23 <property name="connection.useUnicode">true</property>
24 <property name="connection.characterEncoding">UTF-8</property>
25 {{/code}}
26 )))

Get Connected