Path / documentation / ez publish / technical manual / 3.7 / 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

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

Extension base directory

The archive must be copied into the "extension/" directory in the root of the eZ publish installation. If this directory does not exist yet, then create it. Make sure that you do not create the folder with the plural naming "extension s/" - this is a common error.

For example, on a Linux system do

# create extension/ directory
mkdir /path/to/ezpublish/extension/
# copy the archive
cp /download/dir/ezfoo-extension-1.0.tar.gz /path/to/ezpublish/extension/

Unpack the archive

Next, unpack the files from the archive. See the following table for the correct command to chose on a Linux-like 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



Windows users can extract an archive with common tools like WinZip, which preferably work with the "zip" file.

Extracting the archive will add the directory "ezfoo/" to the extension folder:


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

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


There are no comments.