This section covers migrating an existing SuiteCRM 7 instance to SuiteCRM 8. This is a migration, not an upgrade — it involves setting up a new SuiteCRM 8 environment and moving your SuiteCRM 7 data into it.
Upgrading within SuiteCRM 8? If you are already on SuiteCRM 8 and want to move to a newer 8.x version, see SuiteCRM 8 Upgrade.
Before migrating, your SuiteCRM 7 instance must be on the latest 7.14.x version. Upgrade your SuiteCRM 7 instance fully before starting this process.
Check the Compatibility Matrix to confirm your server environment is supported by the target SuiteCRM 8 version.
Before You Migrate — preparation steps, backup, and environment checks
Running the Migration — step-by-step migration commands
Troubleshooting — logs, debugging, and common issues
If you are migrating to a version between 8.2.0 and 8.6.x, see the Migration guide for 8.2.0–8.6.x.
Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.