Migrating from SugarCRM CE

SuiteCRM provides a migration pack that allows you to move an existing SugarCRM Community Edition 6.x installation across to SuiteCRM 7. The migration pack is applied using the same Upgrade Wizard used for standard SuiteCRM upgrades.

Compatibility

Source version Target version

SugarCRM CE 6.5.x

SuiteCRM 7.6.6

After completing the migration to 7.6.6, upgrade to the current SuiteCRM 7 release using the standard upgrade process.

Before you start

Complete the same preparation steps as for a standard upgrade:

  • Back up your SugarCRM CE files and database — this is your only recovery option if something goes wrong

  • Confirm your PHP version, database, and web server are supported by SuiteCRM 7.6.6 — check the Compatibility Matrix

  • Test the migration on a copy of your production environment before running it on production

  • Review your customisations — any code changes made directly to SugarCRM CE core files will need to be re-applied after migration using SuiteCRM’s upgrade-safe /custom directory approach

  • Configure PHP limits as per the Before You Upgrade checklist

Download the migration pack

Download the SugarCRM CE Migration Pack from the SuiteCRM releases page.

The pack is named: SuiteCRM-7.6.6-Migration-from-SugarCRM-CE-6.x.zip

Running the migration

The migration pack is applied via the SugarCRM CE Upgrade Wizard, not the SuiteCRM one — you are running this against your existing SugarCRM CE instance.

  1. Log in to your SugarCRM CE instance as an administrator.

  2. Navigate to Admin › Upgrade Wizard.

  3. Work through the wizard steps, uploading the migration pack ZIP when prompted.

  4. Complete the wizard. Your instance will now be running SuiteCRM 7.6.6.

Post-migration steps

  1. Navigate to Admin › Repair and run Rebuild Relationships and Rebuild Extensions.

  2. Review your customisations and re-implement any that were lost.

  3. Verify data integrity — check key modules (Accounts, Contacts, Opportunities) for completeness.

  4. Upgrade to the current SuiteCRM 7 release following the upgrading guide.

The migration pack brings your instance to SuiteCRM 7.6.6 only. It is strongly recommended to upgrade to the latest 7.x release promptly to benefit from security fixes and current support.

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.