Step 1: Preparation and Backups
-
Back up everything: Create a complete snapshot/backup of your web directory and database.
-
Check environment limits: Increase PHP execution time and Apache/Nginx timeouts (e.g.,
max_execution_time = 600and ApacheTimeout 900) to prevent HTTP 500 timeouts during heavy upgrade tasks. -
Verify PHP version: Ensure your server runs a compatible PHP version for the intermediate steps before jumping to PHP 8.4 for 7.15. [1, 2, 3, 4, 5]
Step 2: Phase 1 Upgrade (7.12.9 to 7.14.x)
-
Visit the SuiteCRM Download/Releases Page to grab the specific intermediate upgrade package (e.g.,
SuiteCRM-Upgrade-7.12.x-to-7.14.x.zip). -
Log into your SuiteCRM 7.12.9 instance as an administrator.
-
Navigate to Admin → Upgrade Wizard.
-
Upload and run the
7.12.x-to-7.14.xpackage through the preflight and commit steps. [1, 2, 3]
Step 3: Phase 2 Upgrade (7.14.x to 7.15.x)
-
Download the latest
SuiteCRM-Upgrade-7.14.x-to-7.15.xpackage (or direct package to7.15.2) from the official SuiteCRM Releases. -
Go back to Admin → Upgrade Wizard in your updated 7.14 environment.
-
Upload the 7.15 upgrade zip, review the preflight/schema scripts, and commit the upgrade.
-
Clear your browser cache and run a Quick Repair and Rebuild from the Admin panel.