This section describes how to deploy an eZ publish bundle in a Linux/UNIX based operating environment.

1. Download an eZ publish bundle.
The latest bundles can be downloaded from http://ez.no/developer/download. Make sure you download a bundle that is compatible with the target operating system.

2. Unpack the bundle.

$ tar xvfz ezpublish-x.x.x-x.OS-DISTRO.i386.tar.gz

3. Become the root user.

$ su - 

4. Run the installation script.

# cd ezpublish-x.x.x-x.OS-DISTRO.i386

# ./install.sh

The installation script will present itself within a nice set of dialog screens.

5. From the main menu, choose "Install eZ publish 3".

Previous installations
The installation script will automatically detect previously installed bundles of the eZ publish framework by checking a lock file. If a previous installation already exists on the system: it needs to be removed. Use the "Uninstall eZ publish 3" option from the main menu within the installer script. If a previous version was removed manually then the lock file may still be present. The lock file needs to be removed manually. This is done by deleting "/var/state/ezpublish/ezpublish.lock".

6. 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 under the "/opt/ezpublish" directory (except the lock file, which will be "/var/state/ezpublish/ezpublish.lock".

7. File extraction

The installation script will extract the files within the bundle. This might take a couple of seconds or minutes.

8. Network interface

A dialog will ask for the name of the primary network device (usually the Ethernet controller). On Linux based systems, the interface is usually called "eth0". Hint: use the "ifconfig" command to reveal the name of the interface. Type in the name of the interface and hit OK.

9. Web server port

The installation script will ask for a port number. This port will be used by the web server. In other words: Apache will listen for requests on 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 listening on this port, then another port must be chosen (for example 8085).

10. Installation complete

The final dialog will present you with information about the installation and how the eZ publish system can be reached using a web browser. This information is dynamic and depends on the port that was provided in step 9.

The eZ publish setup wizard has to be run after the installation is finished (it will automatically start the first time the site is browsed). The setup wizard is self-explaining and is used to configure the eZ publish system. You should be able to follow the instructions on the screen. Please refer to "The setup wizard" section, which describes the web based setup wizard.