How To Install Data Migration Tool in Magento 2

Reading Time: 2 minutes

06iioySiThis a guest blog post by Wajid Hussain. Wajid is Magento Community Manager at Cloudways – Managed Magento Hosting Platform. He has a vast experience in Magento and PHP related fields. You can follow him on Twitter at @wajidstack or contact him at wajid.hussain(at)

Now to Install Magento 2 Miration Tool

For easy migration of Magento, there is a handy Data Migration Tool. This Data Migration Tool is based on the command line (CLI) that provides verification, logging, progress tracking and test functions.

There are three modes of transfer that migrate data from your Magento 1 store to Magento 2.

  • Data Mode: This is bulk migration mode that migrates data from Magento 1 database to Magento 2 database.
  • Delta Mode: This migration mode is Catch up migration after the bulk data migration
  • Settings Mode: This migration mode migrates all possible configuration settings from Magento 1 to Magento 2.

Every mode has its own stages, for example, EAV step, settings step, URL rewrite step. Every step checks integrity of data in Magento 1 and Magento 2 databases. After the integrity is checked the data is transferred and confirmed again.

Requirements for Installation Data Migration Tool

Before the installation of Data Migration Tool make sure you are using same versions of Magento and the Data Migration Tool. If you are using Magento 2 latest version, you must also use the latest version of Data Migration Tool.

How To find Magento 2 software version

To find your Magento 2 software version:

  • If you have downloaded the Magento 2 software using composer use following command:

If you are in the developer branch, Firstly you must need to change this to a released branch before you continue.

How to Find Data Migration Tool version

To find your migration tool version:

  • First, change your Data Migration Tool directory: vendor/Magento/data-migration-tool.
  • Open your composer.json file in the editor and find the value of “Version” The value defined is the current version of your tool.

Installing Data Migration Tool

There are two ways of install Data Migration Tool. You can install it using or use Github repository.

Before continuing make sure you completed all the tasks mentioned above.

Install Data Migration Tool Using

For installation of Data Migration Tool first, you must update composer.json in the Magento 2 root directory that provides the location of the Data Migration Tool package.

Install the Data Migration Tool:

  • Log in to your Magento 2 server and switch the Magento 2 file system owner using this command: su magento_user
  • Use these following commands:

Use your Data Migration Tool version, and replace this <version> tag with your Migration Tool version. E.G:

It will produce authentication keys. Go to and log in with your username and password, click on the secure key option under Developers options.


Here the public key is your username the and private key is your password.

Install Data Migration Tool Using GitHub

You can also use Github to install the data migration tool on Magento 2. Follow this step to install the Data Migration Tool from GitHub:

Use following commands:

Use your Data Migration Tool version, and replace this <version> tag with your Migration Tool version. E.G:

Final Thoughts: In this article Wajid picked most necessary steps for installation of Data Migration Tool. Leave your comments & suggestions in the below comments section.


  1. Hey,
    This blog incredibly covers all the points To Install Data Migration Tool in Magento 2 . Thank you for writing such an informative blog.


Please enter your comment!
Please enter your name here