eZ Documentation Center

This is outdated documentation made for eZ Publish Platform 5.2. It is being moved into the eZ Publish 5.x documentation, so please go there for most up-to-date documentation.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added links to vHost and .htaccess. Added table of contents in the top, to replace the wrong and incomplete list of steps


This section will guide you through the following steps:

  • Setting up / creating a database
  • Downloading a packaged eZ Publish distribution
  • Unpacking the eZ Publish distribution
  • Prepare the extracted files
    • Link your assets
  • (Optional) Configure a VirtualHost
  • Initiating and going through the web based setup wizard at http://<your-host-name>/ezsetup
  • (Optional) Set up scheduled tasks

Table of Contents

Setting up a database

Known issue with running PHP5.3 on MySQL: Some Windows users with both IPv4 and IPv6 installed experience problems connecting to the database server using host names like "localhost"... If you experience problems, try using IPv4 address like "". This is due to a connectivity problem when running PHP5.3 on MySQL. So, please replace the database server name "localhost" with the IP address of the machine, or "", which is reserved for the local host.


Use your favorite utility to unpack the downloaded eZ Publish archive to a web-served directory (a directory that is reachable using a web browser). The extraction utility will unpack eZ Publish into a subdirectory called "ezpublish-5.x.y". Feel free to rename this directory to something more meaningful, for example "my_site".


Link assets

The download file should already have generated these assets for you as of 5.2 / 2013.07, but in case of issues on Windows with symlinks within the download file, make sure to run these commands.


No Format
cd /<ezp5-root>
php ezpublish/console assets:install --symlink web
php ezpublish/console ezpublish:legacy:assets_install --symlink web
php ezpublish/console assetic:dump --env=prod web

Note: In both cases "web" is the default folder and can be skipped from the command. Further information about alternative options is available with -h just like it is with "php ezpublish/console -h".

Note: On windows, you will need an elevated prompt, which means you will need Administrator privileges for the symlink command to work.

You can choose between a Virtual Host based configuration, or a non Virtual Host configuration by using an .htaccess file.

Virtual host

For help on how to set up a virtual host and rewrite rules on IIS, you will find some information on the community website (e.g. in this forum thread).