---
title: "Berlioz config"
source: https://dev.pageseeder.com/reference/advanced/website/berlioz/configuration/config.html
last_updated: 2026-08-07T17:09:54+10:00
tokens: ~631
---

# Berlioz global properties

The Berlioz global configuration file is a simply a list of properties for the content generators running in Berlioz.

```text

/WEB-INF/config/config-[mode].xml
```

Properties defined this way are available in the content generators using the `GlobalSettings` class.

## Predefined Berlioz properties

The following properties are defined by Berlioz.

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| berlioz.http.compression | Boolean | `true` | To allow Berlioz to use HTTP compression when possible |
| berlioz.http.get-via-post | Boolean | `true` | To forward HTTP POST requests to GET is there is no specific service for POST |
| berlioz.http.max-age | Integer | 60 | The default maximum age in seconds of cacheable content |
| berlioz.errors.handle | Boolean | `true` | To allow Berlioz handle errors (they are sent to Web container |
| berlioz.errors.generator-catch | Boolean | `true` | To catch errors thrown by generators |
| berlioz.xslt.cache | Boolean | `true` | To enable the caching of XSLT templates |
| berlioz.xml.parse-strict | Boolean | `true` | To throw XML/XSLT errors even for warnings |
| berlioz.control-key | String | "" | Specifies a control Key: a string required to use Berlioz global |

## File format

There are three possible file formats for the global properties settings, they are the following:

### Simple XML file

This is a minimal representation with the property name generated by concatenating the attribute with the parent element and the attribute value being the value of the property. The \<`document>` element is ignored.

For example:

```xml

<global>
  <myapp test="abc" acme="true"/>
</global>
```

creates the following property:

| Name | Value |
| --- | --- |
| myapp.acme | true |
| myapp.test | abc |

### XML properties file

This is a terse representation of the properties in XML:

```xml

<?xml version="1.0"?>
<!DOCTYPE service-config PUBLIC "-//Berlioz//DTD::Properties 1.0//EN"
           "http://www.weborganic.org/schema/berlioz/properties-1.0.dtd">
<properties>
  <root>
    <map/>
    <!-- Berlioz Global settings -->
    <node name="myapp">
      <map>
        <entry key="test" value="abc"/>
        <entry key="acme" value="true"/>
      </map>
    </node>
  </root>
</properties>
```

> **Warning:**  Unless you have a specific reason, always use the Simple XML format.

### Properties file

It is also possible to use a conventional properties file format.

```text

myapp.test=abc
myapp.acme=true
```