Skip to content

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.


  1. Make a backup before upgrading.
  2. Disable cron (at Administration > Settings) before upgrading. Enable it back after the upgrade is finished.
  3. Enable Maintenance Mode (at Administration > Settings) before upgrading. Disable after the upgrade is finished.
  4. 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="" − install a specific upgrade package (path to file).

Example of using parameters:

php command.php upgrade -y --file=""

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/

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 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.