How to Install Magento 2 Data Migration Tool

Magento has ended the support for Magento 1, which has compelled the merchants to migrate to Magento 2.

Not only for security purpose, but Magento 2 is far better than Magento 1 in every aspect, be it performance, SEO-friendly, or modern tech stack.

And with the release of Magento 2.4, there’s no looking back! The latest release has everything from 2FA security, new media gallery, PWA development, and headless commerce!

It is not surprising that a store owner will be prompted to download Magento 2.4 and migrate to this latest version to leverage its performance and security advantages.

However, the process to migrate from Magento 1 to Magento 2 is a complex one. Although it is recommended to hire certified Magento developers for the Magento migration if you are confident to carry it out yourself, you can refer the tutorial to install Magento 2 data migration tool.

It is the official tool by Magento released to help merchants migrate from Magento 1 to Magento 2.

Requirements to use Data Migration Tool:

You need to use the same released version of Magento 2 and the Data Migration Tool. For example, If you using Magento 2.3.5, you need to use the data migration tool of that version too.

You can use one of the eight methods available to check Magento version.

Method to Install Magento 2 Data Migration Tool:

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

$ php <magento_root>/bin/magento –version

If you cloned the Magento 2 Github repository, run these commands:

$ cd <your Magento 2 clone directory>

$ git branch

Now, if you are in the “develop” branch, do not forget to change to a released branch before going ahead.

Also, install Magento by now.

Visit Releases of the Data Migration Tool GitHub repository to find available released versions.

Installing Magento 2 Migration Tool

1. Install from repo.magento.com

   1. Login to Magento servers or switch to Magento file system owner
   2. Change to Magento 2 root directory
   3. Run the below commands
      $ composer config repositories.magento composer https://repo.magento.com
      $ composer require magento/data-migration-tool:<version>Here, <version> is the version of the Magento 2 codebase.
   4. Enter the authentication keys. Your username is the public key and password is the private key.

2. Install from GitHub

   1. Login to Magento servers or switch to Magento file system owner
   2. Change to Magento 2 root directory
   3. 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.

Check the version of the installed Magento Data Migration Tool:

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

Any doubts about the method to install the Magento 2 migration tool? If so, feel free to mention them in the Comments section below. I’d be happy to help.

Also, do not forget to share Magento 2 data migration tool tutorial with the store merchants via social media.

Thank you.