🔥 Just Launched! Werra Premium Template for HyväSee it in Action

How to Install Magento 2 Data Migration Tool – Tutorial 

By Sanjay JethvaUpdated on Jun 06, 2025 4 min read

Migrating from Magento 1 to Magento 2 using a Magento 2 data migration tool helps to move all your products, customers, orders, and other data more efficiently. 

In this blog, I will show you the available migration methods and how to install the Magento 2 data migration tool using both methods. 

Data Migration Tool Requirements

Here are the key requirements before using the Magento Data Migration tool: 

  • Check your Magento version and make sure it has the same vision as Magento 2 as the Data Migration Tool. If you use Magento 2.3.5, the data migration tool must follow the same version. 
  • Use a topology and design that matches your Magento 1 store.
  • Verify that the Digital Migration Tool has network access to easily connect with Magento 1 and 2 databases.
  • Your MySQL has the necessary privileges to access Magento databases. 

Methods to Install Magento 2 Data Migration Tool

There are two methods to configure the data migration tool: Official repositories and GitHub repositories.

  • Official Repositories: This method uses Composer to install the data migration tool, and this is a recommended method to ensure compatibility between your Magento 2 version and the tool. 
  • GitHub Repositories: Here, you can install the tool by cloning it directly from the official Magento GitHub repository. You can use this method for development or to explore the source code. 

Steps to Install Data Migration Tool: Using Repositories

Step 1: Check the CLI Version 

If you have downloaded the Magento using Composer metapackage, run the below command:

$ php <magento_root>/bin/magento –version

Step 2: Add Magento Repository to Composer

Login to your Magento server or switch the Magento file system owner and navigate to the Magento 2 root directory. 

Then, run the below command:

$ composer config repositories.magento composer https://repo.magento.com

Step 3: Install Data Migration Tool

Now install the data migration tool based on the version you are using:

$ composer require magento/data-migration-tool:<version>Here, <version> is the version of the Magento 2 codebase.

Replace <version> with the exact Magento version, for example, Magento 2.4.7. 

Then, enter the authentication keys with your username and password. 

Install Magento 2 Data Migration Tool via GitHub

Step 1: Check Magento 2 Git Branch
If you cloned the Magento 2 Github repository, run these commands:

$ cd <your Magento 2 clone directory>
$ git branch

Step 2: Add the Data Migration Tool 

Now login to the Magento servers or switch to Magento file system owner.

Change to the Magento 2 root directory and run the below commands

$ composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool
$ composer require magento/data-migration-tool:<version>Here, <version> is the version of the Magento 2 codebase.

After completing the installation process, check the version of your Magento migration tool. 

Here are the steps to check the version:

  • Change to your Data Migration Tool directory: <vendor>/magento/data-migration-tool.
  • Open composer.json in a text editor.
  • The version entry in that file is the version of the Data Migration Tool.

Error Messages While Using the Data Migration Tool (Cause + Solution) 

While configuring the tool, you might encounter some errors. Here are the possible errors with its cause and solution. 

Error Message Cause Solution 
  • bash Source documents are not mapped: <EXTENSION_TABLE>
  • Some Magento 1 entities don’t exist in the Magento 2 database Install Adobe Commerce 2 extension. Check if the error data originates from any extension.
  • Class <extension/class_name> is not mapped in record <attribute_id=196>
  • A class from Adobe Commerce 1 codebase is not found in Adobe Commerce 2 codebase. Install the extension and add class mapping using the class-map.xml.dist file.
  • There are duplicates in URL rewrites
  • The target path in a URL is paired with Request path + Store IDEnable the auto_resolve_urlrewrite_duplicates option in your config.xml file.

    Other Common Issues While Installing Magento 2 Data Migration Tool 

    • Version Compatibility Issues – If your version doesn’t match the data migration tool, then the migration will stay incomplete.
    • Extension Compatibility Issues – Use Magento 2 compatible extension since the M1 extension won’t support M2.
    • Composer Conflicts – Solve any conflicting dependencies that can cause errors during installation.
    • Permission Access – Give proper read/write access to your Magento directories. 

    Hire Magento Migration Experts  

    Configuring Magento 2 data migration tool is an excellent choice to migrate your store data, but if not done correctly, there is a high chance that your migration will remain incomplete. 

    Use our Magento 2 migration service to move to the latest version of Magento 2 without any data loss and minimum downtime. Our expert’s Adobe-certified experts make your new Magento store run without any uninterrupted errors.

    Magento 1 to Magento 2 Migration Service

    Move to Magento 2 with 100% data security!

    Migrate Safely Now!
    Sanjay Jethva Full Image
    Article bySanjay Jethva

    Sanjay is the co-founder and CTO of Meetanshi with hands-on expertise with Magento since 2011. He specializes in complex development, integrations, extensions, and customizations. Sanjay is one the top 50 contributor to the Magento community and is recognized by Adobe. His passion for Magento 2 and Shopify solutions has made him a trusted source for businesses seeking to optimize their online stores. He loves sharing technical solutions related to Magento 2 & Shopify.