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 and custom code, themes, and customizations.
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. See the Magento Migration Guide for details.
Extensions and custom code
We've been working hard with the development community to help you use your Magento 1 extensions in Magento 2. Now we're proud to present the Magento Marketplace, where you can download or purchase the latest versions of your favourite extensions.
Also, we have developed the Code Migration Toolkit, which will help to port extensions and your custom code to Magento 2, significantly reducing your porting efforts.
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.
This edition of tool supports the following versions for migration:
Magento Open Source version 1.6.x, 1.7.x, 1.8.x, 1.9.x
Magento Commerce version 1.11.x, 1.12.x, 1.13.x, 1.14.x
If you migrate from Magento Open Source to Magento Commerce, the following versions are supported:
- 1.6.x, 1.7.x, 1.8.x, 1.9.x
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.
- 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.3.0). To find the version of either package, open
composer.json and find the value of
Install the tool from GitHub
To install the 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 web server user.
Go to Magento 2 root directory.
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>
<version>is release version (e.g. 2.3.0)
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:
Decide the version of
magento/data-migration-toolyou want as discussed in the preceding section.
composer requirecommands to update
When prompted, enter your authentication keys. Your public key is your username; your private key is your password.
Log in to your Magento server as the web server user or as a user with
Change to your Magento installation directory.
Enter the following command to reference Magento packages in
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>
<version>is either an exact version or next significant release syntax.
Exact version example:
composer require magento/data-migration-tool:2.3.0
Next significant release example:
composer require magento/data-migration-tool:~2.3
Wait while dependencies are installed.
See the Migration Guide for the detailed help with your data migration process.