Before You Upgrade

Review the following before running an upgrade.

Compatibility

Make sure your system complies with the compatibility matrix for the version you are upgrading to. See the Compatibility Matrix for supported PHP, database, and web server versions.

Test before production

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

Back up your instance

Before upgrading, create a backup of both your instance files and your database.

APP_ENV

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

Custom files

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

Error reporting

By default, the upgrade 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.