This module provides drush support for upgrading from Drupal 6 or 7 to Drupal 8. The plan is for this drush support to be added to drush itself at some point, at which point this module will become obsolete.


Because the core migration system has been experimental thus far in Drupal 8, there have been core API changes in each minor version of Drupal requiring different versions of migration modules to maintain compatibility.

  1. 8.x-3.x: This branch works with Drupal 8.2.x (and hopefully above - the plan is for the core migration APIs to stabilize as of 8.2.x).
  2. 8.x-2.x: This branch works only with Drupal 8.1.x.
  3. 8.x-1.0 release: This works only with Drupal 8.0.x. Note that this version included a web UI for the upgrade process - this UI moved into Drupal core with 8.1.x.


To run a complete upgrade of your legacy Drupal site to the current D8 site:

drush migrate-upgrade --legacy-db-url=mysql://user:pass@ --legacy-root= 

You can also add a --configure-only option, which instead of running the migration will generate migration configuration entities, which may then be edited to customize the migration path and run using the migrate_tools module.

UI (8.x-1.0 only)

After installing, visit /upgrade in your browser to access the interface.

Bug reports

It is important to note that this module only provides the front-end to the upgrade process - if you see a problem with the results of your migration, this is almost certainly an issue with the core framework, and should be reported to the core issue queue with a component of "migration system".

Supporting organizations: 
Module author/maintainer
Employer of author/maintainer at original module development time
Testing and applying patches
Sponsored restoration of --configure-only for 8.x-2.x

Project Information