Magento 2.4.9 Unlocks MariaDB 10.11.x Compatibility: Solving the 'RDBMS Not Supported' Error

Magento 2.4.9 Unlocks MariaDB 10.11.x Compatibility: Solving the 'RDBMS Not Supported' Error

As an e-commerce migration expert at Shopping Mover, we frequently encounter database compatibility challenges during Magento 2 installations and upgrades. A recent GitHub issue (magento/magento2#40785) highlights a common problem: the "Current version of RDBMS is not supported" error when attempting to install Magento Open Source with MariaDB 10.11.14.

The Challenge: MariaDB 10.11.14 and Magento Installation Failure

The user, othqsa95, reported a persistent installation failure with Magento Open Source, specifically encountering the "Current version of RDBMS is not supported" message. This error occurred despite using a relatively recent MariaDB version (10.11.14). The core questions revolved around official support for MariaDB 10.11.x, compatible Magento versions, and which MariaDB versions Magento officially supports.

The Community Solution: Magento 2.4.9 and Beyond

The community quickly provided a definitive answer. A key contribution from hostep clarified that official support for MariaDB 10.11 was introduced in a specific commit (

9f18dec3e0de2bd5db1fd5c8a03d81e4e80581fd
) within the Magento 2 codebase. These crucial changes were integrated into Magento 2.4.9-beta1 and are slated for the stable release of Magento 2.4.9. This means that any Magento Open Source or Adobe Commerce installation from version 2.4.9 onwards will natively support MariaDB 10.11.x.

For developers and system administrators needing to verify RDBMS compatibility for specific Magento versions, hostep also provided an invaluable tip. The supported database versions are declared within the Magento core configuration file. You can inspect this file by navigating to:

https://github.com/magento/magento2/blob/[MAGENTO_VERSION]/app/etc/di.xml#L1876-L1882

By replacing [MAGENTO_VERSION] with the desired Magento release (e.g., 2.4.9, 2.4.8-p4), you can directly check the declared compatible MariaDB and MySQL versions. This method offers a reliable way to confirm compatibility without relying solely on documentation, which might sometimes lag behind development.

Implications for Magento Merchants and Developers

This insight is critical for anyone planning a new Magento 2 installation or considering an upgrade. If you're encountering the "RDBMS not supported" error with MariaDB 10.11.x, your current Magento version is likely older than 2.4.9. The immediate solutions are:

  • Upgrade Magento: The recommended path is to upgrade your Magento Open Source or Adobe Commerce instance to version 2.4.9 or newer to leverage full compatibility with MariaDB 10.11.x.
  • Downgrade MariaDB: As a temporary workaround, if a Magento upgrade isn't immediately feasible, you might consider using an older, officially supported MariaDB version (e.g., 10.6, 10.4) that is compatible with your current Magento release. However, this is generally not advised for long-term stability or security.

Ensuring your database environment aligns with Magento's official requirements is paramount for a stable and performant e-commerce platform. Always consult the official Magento documentation or, as demonstrated here, the codebase itself for the most up-to-date compatibility matrices.

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools