# Migrating to MariaDB from MySQL

MariaDB Server is designed to be a high-performance, drop-in replacement for MySQL. Whether you are moving from legacy versions (5.5, 5.6, 5.7) or modern releases (8.0, 8.4 LTS), this section provides the tools and workflows needed for a successful transition.

## Evaluate Compatibility

{% columns %}
{% column %}
{% content-ref url="moving-from-mysql/mysql-to-mariadb-compatibility-matrix" %}
[mysql-to-mariadb-compatibility-matrix](https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/migrating-to-mariadb/moving-from-mysql/mysql-to-mariadb-compatibility-matrix)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Before moving data, understand the technical differences between your current MySQL version and your target MariaDB version. Our Compatibility Matrix covers changes in authentication, SQL syntax, and system variables. It's a detailed reference for DBAs and developers.
{% endcolumn %}
{% endcolumns %}

## Choose Your Migration Path

{% columns %}
{% column %}
{% content-ref url="moving-from-mysql/mysql-to-mariadb-migration-the-master-guide" %}
[mysql-to-mariadb-migration-the-master-guide](https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/migrating-to-mariadb/moving-from-mysql/mysql-to-mariadb-migration-the-master-guide)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
The best method for migration depends on your downtime requirements and server architecture. We have consolidated these workflows into a single authoritative guide.

* [MySQL to MariaDB Migration: The Master Guide](https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/migrating-to-mariadb/moving-from-mysql/mysql-to-mariadb-migration-the-master-guide) — Step-by-step instructions for:
  * In-Place Upgrades: Fast, same-server binary swaps.
  * Logical Migrations: Safe, cross-server dump and restore.
  * Cloud & RDS Migrations: Specialized paths for managed environments.
    {% endcolumn %}
    {% endcolumns %}

## Specialized Migration Scenarios

{% columns %}
{% column %}
{% content-ref url="moving-from-mysql/migration-from-mysql-to-mariadb-cluster-using-replication" %}
[migration-from-mysql-to-mariadb-cluster-using-replication](https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/migrating-to-mariadb/moving-from-mysql/migration-from-mysql-to-mariadb-cluster-using-replication)
{% endcontent-ref %}

{% content-ref url="moving-from-mysql/migration-from-mysql-to-mariadb-cluster-node-by-node-in-place" %}
[migration-from-mysql-to-mariadb-cluster-node-by-node-in-place](https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/migrating-to-mariadb/moving-from-mysql/migration-from-mysql-to-mariadb-cluster-node-by-node-in-place)
{% endcontent-ref %}
{% endcolumn %}

{% column %}
Guides for migrating MySQL Galera Cluster to MariaDB Galera Cluster.
{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mariadb.com/docs/server/server-management/install-and-upgrade-mariadb/migrating-to-mariadb/moving-from-mysql.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.