Skip to content

Installation

Prerequisites

  • Drupal 10 or 11 — The target site must run a supported Drupal version.
  • CRM — The CRM module must be installed and enabled.
  • Migrate Plus — The Migrate Plus module is required for the migration definitions.

Install and enable the module

From your Drupal application root (where composer.json and web/ live):

composer require drupal/crm_migrate_crm_core
drush en crm_migrate_crm_core -y

If you install the module from a custom or contrib path, enable it with Drush or via Extend in the admin UI.

D7 database connection

The migration source plugins read from the Drupal 7 database. Configure a second database connection in your Drupal 10/11 site under the migrate key so the migrations use it.

Add the following to settings.php (or a settings include such as settings.migrate.php):

$databases['migrate']['default'] = [
  'database' => 'your_d7_database',
  'username' => 'your_user',
  'password' => 'your_password',
  'host' => 'localhost',
  'port' => '3306',
  'driver' => 'mysql',
  'prefix' => '',
  'collation' => 'utf8mb4_general_ci',
];

Replace your_d7_database, your_user, and your_password with the credentials for your D7 database. The D7 site must contain the CRM Core and Relation tables.

Using a different database key

If you use a connection key other than migrate, override the source plugin’s key in the migration configuration so it points to your connection. You can do this with a config override in settings.php or a dedicated config file.

After the connection is set and the module is enabled, proceed to Running migrations.