Skip to main content
MariaDB
Get startedContact us
MariaDB
Contact us

Menu

Get started
Webinar

Built for the Agentic Era: Introducing MariaDB Enterprise Platform 2027

Register now

Make the switch

Migration Tool

Intelligent assessment, planning, and automated orchestration for your move from MySQL to MariaDB

Download tool
Contact us

mariadb-migrator

What is the MariaDB MySQL Migration Tool?

The MariaDB MySQL Migration Tool is an intelligent  orchestrator designed to make moving from MySQL (5.7/8.0/8.4) to Supported Enterprise and Community editions of MariaDB or MariaDB Cloud completely predictable, repeatable, and auditable.

Assess and plan

Migrate with certainty

Before moving any data, the tool’s Assess & Plan mode inspects your source database, validates network stability, and maps out your exact migration journey. It automatically generates a comprehensive user assessment report, allowing your DBAs to preview exactly how schemas, users, and privileges will seamlessly port over.

Once the assessment is clear, the tool provides four distinct migration pathways — ranging from offline parallel streaming to continuous zero-downtime online replication — all executable via a friendly interactive menu or a non-interactive CI/CD orchestrator CLI.

Download now (opens in a new tab)

Assessment and orchestration capabilities

The tool analyzes your source database and automatically handles or flags the following:

Security and user porting

Legacy hashes

Preserves mysql_native_password authentication hashes.

Modern plugins

Safely provisions temporary passwords with
PASSWORD EXPIRE for caching_sha2_password users.

Role mapping

Automated detection and recreation of MySQL roles.

Schema and compatibility assessment

Data types

Flags compatibility roadblocks (e.g., hidden JSON columns).

Data types

Flags compatibility roadblocks (e.g., hidden JSON columns).

Replication integrity

Validates proper binlog formats and network connectivity.

Performance and automation

Parallel execution

Table loads and chunking of large tables in  parallel worker sessions.

Restartable

Within-run auto-retries on transient errors.

Validations

Row-count or byte validation after every load

Day-one performance

Injects an automated ANALYZE TABLE phase to rebuild optimizer statistics before traffic cutover.

Self-Bootstrapping

Automatically creates its own local Python virtual environment  for immediate use.

Four migration pathways

No matter your maintenance window or infrastructure size, the tool adapts to your requirements.

one_step

Serial streaming copy

Direct network pipe for predictable, standard maintenance windows.

Best for:

Small to mid databases, simple topology, the fastest path when downtime is acceptable.

two_step

Parallel streaming copy

High-speed, multi-threaded load chunking for massive datasets.

Best for:

When schema and data benefit from independent tuning, or when parallel data load matters and running from a independent tools server.

staged

Offline staged copy

Phase-driven load for air-gapped systems or complex cloud shifts (e.g., AWS RDS to MariaDB Cloud).

Best for:

Air-gapped environments, scheduled maintenance windows, or coordinated multi-team cutovers.

binlog

Continuous replication (binlog)

Online snapshotting and continuous log replication for near-zero downtime cutovers.

Best for:

Production cutovers where downtime must be measured in seconds, not hours.

Get started

Start your migration

Download migration tool (opens in a new tab)
Contact us