ez projects / ezupgrade

Attention please: Due to restructuring legacy services, the eZ Projects service is going to be discontinued. All the current repositories will be migrated to a new platform. More details will be announced soon.


UNIX name Owner Status Version Compatible with
ezupgrade Eirik Alfstad Johansen beta 0.3 3.5.0 > 4.3.0
eZUpgrade is stand-alone application (not an eZ Publish extension) automating
the process of upgrading an eZ Publish installation.


eZUpgrade is stand-alone application (not an eZ Publish extension) automating the process of upgrading an eZ Publish installation.

Using eZUpgrade is as easy as checking it out on the server where the upgrade installation will reside, inputting some configuration settings, and running
ezupgrade from the command line.


eZUpgrade makes a point of doing as little as possible to the original (source) installation. Still, the application is delivered as-is without any warranties of any kind.

You are strongly urged to backup your entire source installation (files and database(s)) before making use of this application.

Supported versions

eZUpgrade is built to be flexible when it comes to adding support for new eZ Publish versions. Depending on the complexity of the change from one eZP version to another, adding support could be as easy as adding some configuration settings to settings/ezupgrade.ini. For more complex changes, one might need to create some custome upgrade functions. The matrix above describes which versions that are currently supported.


  • eZUpgrade is dependent upon eZCopy ( and its requirements.

How it works

The old eZ Publish installation can be located either on the same server as the upgraded installation, or on a remote server. If the latter is the case, eZUpgrade will make use of eZCopy to copy the old installation to the new server before starting the upgrade procedure.

eZUpgrade then performs the following steps:

  1. Downloads and unpacks the distro of the version we want to upgrade to.
  2. Copies files (var/, settings/ and extension/) from the old to the new installation, prompting when overrides are needed.
  3. Copies the databases used by the old installation and updates the database connections in the new installation to the db copies.
  4. Performs the upgrade steps needed between the version we are upgrading from and the version we are upgrading to. This includes sql updates, upgrade scripts and any other upgrade actions that can be performed automatically. If there are any upgrade actions that need to be performed manually, you will be informed.
  5. Grants the database user access to the new database(s).


  1. Check out ezupgrade to the server where the upgraded installation will reside.
  2. Check out ezcopy ( to the /lib folder of ezupgrade (making the directory /lib/ezcopy) and and follow its installation instructions. Finally, copy the ezcopy.ini file from lib/ezcopy/settings/ to settings/
  3. Copy settings/account_default.ini and rename the copy settings/account.ini. For each account you need to upgrade, create an Account block with the proper settings.
  4. Run the following command within ezupgrade:
chmod 777 ezupgrade


From the shell prompt, where eZUpgrade is located, run:

php ezupgrade [account_username]

Average rating 5.00 by 1 reviewers.