General parameters

Configuration files

The default configuration file is conf/, it contains all default values. To edit configuration, you should create conf/ and override needed parameters:

// Override parameters below



Do not copy into, as the first one includes the second. You would then create an infinite loop and crash your application.

Multi tenancy

You can load a specific configuration file by passing a HTTP header. This feature is disable by default. To enable it:

$header_name_extra_config = "SSP-Extra-Config";

Then if you send the header SSP-Extra-Config: domain1, the file conf/ will be loaded.

Using Apache, we may set such header using the following:

<VirtualHost *:80>
   RequestHeader setIfEmpty SSP-Extra-Config domain1

Using Nginx, we could use instead:

server {
    location ~ \.php {
        fastcgi_param SSP-Extra-Config domain1;



Lang is selected from browser configuration. If no matching language is found, the default language is used.

Set default language in $lang:

$lang = "en";


You can override messages by creating lang files in conf/, for example conf/


You can adapt how dates are displayed with specifiers (see strftime reference):

$date_specifiers = "%Y-%m-%d %H:%M:%S (%Z)";



You change the background image with your own. Set the path to image in $background_image:

$background_image = "images/unsplash-space.jpeg";

Custom CSS

To easily customize CSS, you can use a separate CSS file:

$custom_css = "css/custom.css";


You can turn on debug mode with $debug:

$debug = true;


You need to define where Smarty is installed:

define("SMARTY", "/usr/share/php/smarty3/Smarty.class.php");