How to upgrade EspoCRM¶
Upgrade from CLI¶
Available from version 5.6.0.
This is the most preferable way to upgrade.
Command to run:
php command.php upgrade
This will check the next available version, download it and install. Once the upgrade is complete, it will prompt to run the command again, if a newer version is available.
Note: Upgrading process may take a while. Do not close the terminal until it's finished.
Recommendations¶
- Make a backup before upgrading.
- Disable cron (at Administration > Settings) before upgrading. Enable it back after the upgrade is finished.
- Enable Maintenance Mode (at Administration > Settings) before upgrading. Disable after the upgrade is finished.
- Make sure you have free disk space on the server.
Additional parameters¶
Available parameters (only for advanced users):
-y
− run w/o user confirmation;-s
− run an upgrade in a single process;--file="EspoCRM-upgrade.zip"
− install a specific upgrade package (path to file).
Example of using parameters:
php command.php upgrade -y --file="EspoCRM-upgrade.zip"
Legacy way to upgrade¶
Before 5.6.0 version. Not recommended for versions since 5.6.0.
Execute the following command from EspoCRM root directory:
php upgrade.php /path/to/upgrade/package.zip
Upgrade from UI¶
This is not recommended way to upgrade. It may cause problems.
Step 1. Check your current version¶
To check your current version, go to Administration > Upgrade page.
Step 2. Download needed upgrade packages¶
Go to the upgrade page https://www.espocrm.com/download/upgrades/ and based on your currect version download needed packages.
Step 3. Run upgrade from Administration panel¶
Go to Administration > Upgrade. Upload and install upgrade packages one by one.