Before You Migrate

Review the following before starting the migration.

On this page, "7.14.x+" refers to any version greater than or equal to 7.14.x.

Compatibility

Make sure your system complies with the compatibility matrix for the target SuiteCRM 8 version. See the Compatibility Matrix.

Upgrade SuiteCRM 7 first

Your SuiteCRM 7 instance must be on the latest 7.14.x version before migrating. Work through any manual steps described in the release notes for each version you pass through.

Test before production

Run the migration on a development or staging instance first. Only deploy to production after testing.

Back up your instance

Create a backup of both your instance files and your database before starting.

APP_ENV

Before running any migration commands, ensure your SuiteCRM 8 instance has APP_ENV set to prod in your .env or .env.local file.

Custom files

The migration process may remove non-core files or directories under the public/legacy/ folder. Review any customisations before migrating.

Error reporting

By default, the migration commands set error_reporting to a less strict mode to suppress warnings: E_ALL & ~E_DEPRECATED & ~E_STRICT & ~E_NOTICE & ~E_WARNING

To apply a stricter mode, add -vvv to each command. This sets error_reporting to E_ALL.

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