Shopping cart

PrismaSell web development agency

Shopping cart

How to Enable Unsupported MariaDB Versions in Magento: A Quick Fix

By Prisma SellJan 28, 2025

If you're working with Magento and encounter the dreaded "Current version of RDBMS is not supported" error, don't panic! This error typically occurs because your database version falls outside the range of officially supported versions. Magento, by default, supports MariaDB versions 10.2 to 10.4, but what if you're using a newer version, like MariaDB 10.11?

Here's a quick and effective workaround to get your Magento site running without downgrading your database.


The Problem

Magento checks for the database version compatibility in its configuration files. If you're using a version outside the allowed range (e.g., MariaDB 10.6 or 10.11), Magento throws an error, preventing you from proceeding.


The Solution: Updating the di.xml File

To allow Magento to accept your MariaDB version, you'll need to make a small edit in the di.xml file. This file contains Magento's dependency injection configuration, including database compatibility settings.

Step-by-Step Guide:

1: Locate the di.xml File: Navigate to the following file in your Magento installation directory:

app/etc/di.xml
Edit the MariaDB Version Range: Open the di.xml file in your preferred text editor. Look for the section that specifies acceptable MariaDB versions. By default, it looks something like this:
<item name=MariaDB-(10.2-10.4) xsi:type="string">^10\.([2-4])\.</item>

Update the Version Range: To allow newer versions, such as MariaDB 10.11, modify the range. Replace the existing line with the following:

<itemname="MariaDB-(10.2-10.11)"xsi:type="string">^10\.([2-9]|10|11)\.</item>
  •  
    • This regular expression ensures that Magento accepts versions from 10.2 up to 10.11.
  • Save the Changes: Save the di.xml file after making the changes.
  • Flush the Cache: After editing the file, clear Magento's cache to apply the changes:
  • php bin/magento cache:flush

If you need help resolving this issue or assistance with any other Magento problem, customization, or custom development, contact us today! Let our experts handle it so you can focus on growing your business. 🚀

[fc id='1' type='popup' button_color='#4488ee' font_color='white']Get Help Now[/fc]