Overview

We're pleased you're considering moving from the world's #1 eCommerce platform—Magento 1.x—to the eCommerce platform for the future, Magento 2. We're also excited to share the details about this process, which we refer to as migration.

Magento 2 migration involves four components: data, extensions, themes, and customizations.

• Data: We've developed the Magento 2 Data Migration Tool to help you efficiently move all of your products, customers, and order data, store configurations, promotions and more to Magento 2.

• Custom code: Code is not ported because it cannot be automated.

• Extensions: We are working with the Magento development community on updating extensions. They will be on Magento Connect when Magento 2 becomes generally available. More information on developing extensions for Magento 2 is available in the Magento 2 Extension Developer Guide.

• Themes and Customizations: Magento 2 uses new approaches and technologies that give merchants an unmatched ability to create innovative shopping experiences and scale to new levels. To take advantage of these advances, developers will need to make changes to their themes and customizations. Documentation is available online for creating Magento 2 themes, layouts, and customizations.

Supported versions

This edition of tool supports the following versions for migration:

• Community Edition (CE) version 1.6.x, 1.7.x, 1.8.x, 1.9.x

• Enterprise Edition (EE) version 1.11.x, 1.12.x, 1.13.x, 1.14.x

Also the following versions are already supported if you choose to migrate from Magento 1 CE to Magento 2 EE:

• 1.6.x, 1.7.x, 1.8.x, 1.9.x

Prerequisites

Before you start your migration, you must do all of the following:

• Set up a Magento 2 system that meets our system requirements.

  Set up your system using a topology and design that at least matches your existing Magento 1.x system.

• Do not start Magento 2 cron jobs.

• Back up or dump your Magento 2 database as soon after installation as possible.

• Check that the data migration tool has a network connection to the Magento 1.x and Magento 2 databases.

  Open ports in your firewall so the migration tool can communicate with the databases and so the databases can communicate with each other.

• To provide redundancy in the event of unexpected issues, we advise you to replicate your Magento 1.x database.

• Migrate Magento 1.x extension and custom code to Magento 2.

  Reach out to your extension providers to see if they have been ported yet.

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 a GitHub repository.

Note: The versions of both the migration tool and the Magento 2 code must be identical (for example, 2.1.0). To find the version of either package, open composer.json and find the value of "version".

Install the tool from GitHub

To install the migration tool from GitHub, use the following steps:

1. Log in to your Magento 2 server as a user with privileges to write to the Magento 2 file system or switch to the web server user.

2. Go to Magento 2 root directory.

3. Enter the following commands:

   composer config repositories.data-migration-tool git https://github.com/magento/data-migration-tool
   composer require magento/data-migration-tool:<version>
   

   where <version> is release version (e.g. 2.1.0)

4. Wait while dependencies are updated.

Install the tool from repo.magento.com

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

To install the migration tool, you must:

1. Decide the version of magento/data-migration-tool you want as discussed in the preceding section.

2. Run the composer config and composer require commands to update composer.json.

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

To update composer.json:

1. Log in to your Magento server as the web server user or as a user with root privileges.

2. Change to your Magento installation directory.

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

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

4. 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.1.0
   

   Next significant release example:

   composer require magento/data-migration-tool:~2.0
   

5. Wait while dependencies are installed.

For more details

See the Migration User Guide.