SuiteCRM 7 Upgrade

This section covers upgrading between SuiteCRM 7.x versions. Each upgrade applies a pack that patches your existing installation in place.

Moving to SuiteCRM 8? That is a migration, not an upgrade, and requires different steps. See Moving to SuiteCRM 8. Coming from SugarCRM CE? See Migrating from SugarCRM CE.

Before you start

Review the Before You Upgrade page before doing anything else. It covers backups, PHP settings, and file permission requirements that apply to both upgrade methods.

Choosing an upgrade method

You can upgrade SuiteCRM 7 using either the Upgrade Wizard in the user interface or the CLI method from the command line on your server. The table below highlights the key differences between the two methods to help you decide which is best for your needs.

Upgrade Wizard (UI) CLI Upgrade

Guided, browser-based

Run from the command line

Suitable for smaller instances (under ~10,000 records per table)

Recommended for larger databases or if the Wizard times out

Requires PHP upload limits to be increased

Avoids web server timeout and upload size constraints

Available in all 7.x versions

Requires SuiteCRM 7.11.3 or newer for the robo command

Upgrade paths

Always upgrade incrementally through the supported version steps. Do not skip major minor versions — check the release notes for each version you pass through to identify any required manual steps.

Upgrade packs are available from the SuiteCRM releases page.

Compatibility

Before downloading an upgrade pack, verify that your PHP version, database, and web server are supported by the target version. See the Compatibility Matrix.

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