Does Mattermost Support MariaDB?

Sven Hüster

Updated May 07, 2025 14:39

Short Answer

No, Mattermost does not support MariaDB.

Details

Mattermost officially supports PostgreSQL and, for legacy installations, MySQL. However, MariaDB is not a supported database for any Mattermost deployment. While MariaDB and MySQL share a common ancestry, they have diverged significantly over time, especially in features, performance characteristics, and compatibility. As a result, running Mattermost with MariaDB can result in unpredictable behavior, data integrity issues, or compatibility problems.

If You're Currently Using MariaDB

If your Mattermost installation currently uses MariaDB, it is strongly recommended that you migrate your database to MySQL or, preferably, PostgreSQL.

Migrating from MariaDB to MySQL

You can follow the official Oracle guide for migrating from MariaDB to MySQL:

👉 How to Migrate from MariaDB to MySQL 8.0

Note: While this will align your database with a currently supported backend, support for MySQL is also scheduled to be sunset with the release of Mattermost v11.

Future-Proof Your Installation

Given the planned removal of MySQL support in Mattermost v11, it's advisable to migrate directly to PostgreSQL if you're undergoing a database transition. PostgreSQL is the recommended and most extensively tested database for all Mattermost deployments going forward.

Migrating from MySQL to PostgreSQL

To assist with this migration, Mattermost provides a step-by-step guide:

👉 How to Migrate from MySQL to PostgreSQL

Summary

Database	Supported	Notes
MariaDB	❌ No	Not supported; migrate to MySQL or PostgreSQL.
MySQL	⚠️ Limited	Supported for now, but support ends with v11.
PostgreSQL	✅ Yes	Fully supported and recommended for all deployments.