Install the Data Migration Tool

This section discusses how to install the Magento Data Migration Tool. You can install it from either repo.magento.com or from the GitHub repository.

To migrate to Magento Enterprise Edition (EE), contact Magento Support.

Before you continue, make sure you completed all tasks discussed in Preconditions.

You should install the Data Migration Tool the same way you installed the Magento software, as follows:

If you installed the Magento 2 compressed archive or using composer create-project, install the Data Migration tool using repo.magento.com.
If you cloned the Magento 2 GitHub repository because you're contributing code to Magento 2, install the Data Migration tool using GitHub.

Install the tool from GitHub for Magento Community Edition (CE)

To install the Data Migration Tool from GitHub, use the following steps:

Log in to your Magento 2 server as a user with privileges to write to the Magento 2 file system or switch to the Magento file system owner.
Change to Magento 2 root directory.

Enter the following commands in the order shown:

    composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool-ce
    composer require magento/data-migration-tool:dev-master

Wait while dependencies are updated.

Install the tool from `repo.magento.com` for Magento CE

To install the Data Migration Tool, you must update composer.json in the Magento root installation directory to provide the location of the Data Migration Tool package.

To install the Data Migration Tool, you must:

Log in to your Magento 2 server as a user with privileges to write to the Magento 2 file system or switch to the Magento file system owner.
Change to Magento 2 root directory.

Enter the following commands in the order shown:

    composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool-ce
    composer require magento/data-migration-tool:dev-master

When prompted, enter your authentication keys. Your public key is your username; your private key is your password.

To update composer.json:

Log in to your Magento server as the switch to the Magento file system owner or as a user with privileges to write to the Magento 2 file system.
Go to Magento 2 root directory.

Enter the following command to reference Magento repo in composer.json:

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

Enter the following command to require the current version of the package:
```
composer require magento/data-migration-tool:<version>
```
where <version> is either an exact version or next significant release syntax.

Exact version example:
```
composer require magento/data-migration-tool:2.0.0
```
Next significant release example:
```
composer require magento/data-migration-tool:~2.0.0
```
Wait while dependencies are installed.

Install the Data Migration Tool