Path / documentation / ez publish / technical manual / 4.x / installation / extensions / extracting the files

Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

Extracting the files

This part of the 4.x documentation is for eZ Publish 4.0, only reference section is common for all eZ Publish 4.x versions as well as eZ Publish 5.x "LegacyStack", please select the version you are using for the most up to date documentation!

Each extension is distributed as a compressed archive. The name of the archive file includes the name of the extension and its release version. Furthermore, the compression type is indicated by the file ending, either "tgz", "tar.gz", "bz2", or "zip". For example:

  • ezfoo-extension-1.0.tgz
  • ezfoo-extension-1.0.tar.gz
  • ezfoo-extension-1.0.bz2

Windows users should download the "zip" archive. Linux/UNIX users may download any archive format as long as the necessary unpacking tools are available.

Extension base directory

Copy the downloaded archive into the "extension" directory of your eZ Publish installation. If this directory does not exist yet, then create it. (Do not create the directory with the plural naming "extensions" - this is a common error.)

The following shell commands can be used to create the "extension" directory and copy the archive on a Linux/UNIX system:

mkdir /opt/ezp/extension/
cp /home/myuser/download/ezfoo-extension-1.0.tar.gz /opt/ezp/extension/

Replace "/opt/ezp/" with the actual path to your eZ Publish installation and "/home/myuser/download/ezfoo-extension-1.0.tar.gz" with the actual path to the downloaded archive.

Unpack the archive

The archive should be unpacked inside the "extension" directory. When done correctly, an "ezfoo" directory will be created inside the "extension" directory.

See the following table for the correct shell command to use on a Linux/UNIX system, depending on the compression type:

Archive type

Command to extract

tar.gz or tgz

tar -zxvf ezfoo-extension-1.0.tar.gz


tar -zxvf ezfoo-extension-1.0.tgz


tar -jxvf ezfoo-extension-1.0.bz2



On Windows, you can just unzip the "zip" file using the built-in zip features.

At this point, the unpacked files should be available under "extension/ezfoo".

Sandro Groganz (22/04/2005 9:08 am)

Ricardo Correia (17/04/2013 10:00 am)

Sandro Groganz, Svitlana Shatokhina, Ricardo Correia


There are no comments.