Global navigation

   Documentation Center
   eZ Studio & eZ Platform
     User Manual
     Technical Manual
   eZ Publish 4.x / legacy

eZ Publish (5.x)

eZ Publish 5.x | For eZ Platform & eZ Studio topics see Technical manual and User manual, for eZ Publish 4.x and Legacy topics see eZ Publish legacy

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Added environment configuration procedures


Refer to the "The setup wizard" section for a detailed description of the web based setup wizard.


Defining the desired environment

Environment configuration is a new feature introduced as of eZ Publish 5.2 and eZ Publish Community Project 2013.06.
You can configure several environments, from production, development or staging, even if for each one of them you need require using different configurations sets.

In the VirtualHost example in the Virtual host setup chapter the required VirtualHost configurations have been already included. You can switch to the desired environment by setting the ENVIRONMENT environment variable to "prod", "dev" or "staging", as you can see in the following example:

No Format
    # Environment.
    # Possible values: "prod", "dev", "staging",...
    # Defaults to "prod" if omitted
    SetEnv ENVIRONMENT "prod"

The next step is to create the dedicated configuration files for your environment:

  • ezpublish/config/config_<env_name>.yml
  • ezpublish/config/ezpublish_<env_name>.yml

Those files must import the main configuration file, just like the default config_dev.yml already does. Here's an example:

No Format
    - { resource: config.yml }

This allows you to override settings defined in the main configuration file, depending on your environment (like the DB settings or any other setting you may want to override).