Path / documentation / ez publish / technical manual / 3.7 / installation / bundled installation / installing an ez publish bu...

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.

Installing an eZ publish bundle on a Linux based system

This section describes how to deploy an eZ publish bundle on a Linux based system:

  1. Download the latest Linux compatible eZ publish bundle from Look for "ezpublish-x.y.z-Linux-STABLE.i386.tar.gz" where "x.y.z" is the version number, for example "3.7.0".
  2. Unpack the bundle:
    $ tar zxvf ezpublish-x.y.z-Linux-STABLE.i386.tar.gz
  3. Become the root user:
    $ su -
  4. Start the installation script:

    # cd ezpublish-x.y.z-Linux-STABLE.i386
    # ./
    The following text explains the various dialog screens of the installation script.

Main menu

Linux installer - step 1

Step 1: Main menu

Select the "Install eZ publish 3" option and hit enter.

Previous installations

The installation script will automatically detect a previously installed bundle by checking a lock file. A previous installation must be removed. Use the "Uninstall eZ publish 3" option from the main menu, the installer will automatically remove the previous bundle. If a previous version was removed manually then the lock file may still be present. Remove the lock file manually by deleting the "/var/state/ezpublish/ezpublish.lock" file.



Linux installer - step 2

Step 2: Confirmation

A dialog will ask for a final confirmation. Choose "Yes". The installation script will then attempt to install all the software included in the bundle. Everything will be put in the "/opt/ezpublish" directory (except the lock file, which will be located at "/var/state/ezpublish/").

File extraction


Linux installer - step 3

Step 3: File extraction

The installation script will extract the files included in the bundle. This may take some time (a minute or two).

Network interface


Linux installer - step 4

Step 4: Network interface

A dialog will ask for the name of the primary network interface (most likely the Ethernet controller). The primary network interface is usually called "eth0". In case of doubt: bring up a shell and use the "ifconfig" command to figure out the name of the interface. It is possible to use the local loopback interface if no physical network interface is present. The name of the local loopback interface is "lo".

Web server port


Linux installer - step 5

Step 5: Web server port

The installation script will ask for a TCP port number. The bundled web server (Apache) will communicate with the rest of the world through this port. The port must not be used by any other service running on the system. The default port for HTTP traffic is 80. If a web server is already using this port, then another port must be chosen (for example 8085).



Linux installer - step 6

Step 6: Summary

The final dialog will display information about the installation and how the eZ publish system can be reached using a web browser. The address will be something like "http://localhost" or "http://localhost:XXXX" where "XXXX" is the actual port number.

The web based setup wizard has to be run after the installation is finished (it will automatically start the first time the site is browsed). You should be able to follow the instructions on the screen. Refer to "The setup wizard" section for a complete step-by-step guide.

Balazs Halasy (13/01/2005 12:57 pm)

Svitlana Shatokhina (18/05/2006 8:37 am)

Balazs Halasy, Svitlana Shatokhina


There are no comments.