Path / documentation / ez publish / technical manual / 3.10 / 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.8.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)

Julia Shymova (18/12/2007 11:10 am)

Balazs Halasy, Svitlana Shatokhina, Julia Shymova


  • Installation Problem; Apache Relocation Error:

    Followed the instructions above for the eZ publish 3.8 Linux installer and I got a "connection refused" error when trying to reach the eZ publish site on localhost or from another workstation. I'm using an old Red Hat 9 workstation.

    I checked the System Monitor and neither Apache nor MySQL were running. I don't know a whole lot about Linux but was poking around the eZ installed files and bumped into th eZ_apache.log. Here's it's content:

    /opt/ezpublish/apache_1.3.33/bin/httpd: relocation error: /opt/ezpublish/apache_1.3.33/bin/httpd: symbol _sys_siglist, version GLIBC_2.3.3 not defined in file with link time reference
    /opt/ezpublish/apache_1.3.33/bin/apachectl start: httpd could not be started

    What caused this error and how do I correct it should I need to reinstall?
  • fails to run if there's a newer dialog installation

    I had all sorts of fun and games when I tried to install using the bundle and

    When I ran it just failed silently with no output at all and no diagnostics. After a bit of investigation I found out that it was because I have a newer version of 'dialog' installed on my system (Slackware 11) and that has a version of /etc/dialogrc that the ezpublish version of dialog can't understand.

    I think you need to give dialog a parameter so it uses your version of dialogrc, not the default at /etc/dialogrc.
  • Error

    Hi, I installed the Linux Bundle of Version 3.9.2, 3.9.1 and 3.8 on Suse 9.3 and 10.2. In all cases the Apache doesn´ t start:
    /opt/ezpublish/apache_1.3.33/bin/httpd: error while loading shared libraries: cannot open shared object file: No such file or directory
    /opt/ezpublish/apache_1.3.33/bin/apachectl start: httpd could not be started

    Can anyone help me?
  • installing ezpublish 3.9.2 on a suse 10, suse 9.3 and redhat 5


    I installed ezpublish with this commande ./ ( in README) but i have always this message when i would start the wizard in browser :

    Can't start server : bind on tcp/ip port : address already in use
    Do you already have another mysqld server running on port: 3400?
    /opt/ezpublish/mysql-4.1.14/libexec/mysqld: shutdown complete

    Can you help me please???
    • Re: installing ezpublish 3.9.2 on a suse 10, suse 9.3 and redhat 5


      you have to use the commande:
      sudo ./