XBackBone/docs/configuration.md

layout	title	nav_order
default	Configuration	3

Configuration

Web Server

Apache need the mod_rewrite extension to make XBackBone work properly.

If you do not use Apache, or the Apache .htaccess is not enabled, set your web server so that the static/ folder is the only one accessible from the outside, otherwise even private uploads and logs will be accessible!

If you are using NGINX, you can find an example configuration nginx.conf in the project repository.

Maintenance Mode

Maintenance mode is automatically enabled during an upgrade using the upgrade manager. You can activate it manually by editing the config.php, and adding this line:

return array(
    ...
    'maintenance' => true,
);

Database support

Currently, is supported MySQL/MariaDB and SQLite3.

For big installations, MySQL/MariaDB is recommended.

Example config:

return array(
    ...,
    'db' => array (
        'connection' => 'mysql', // sqlite or mysql
        'dsn' => 'host=localhost;port=3306;dbname=xbackbone', // the path to db, if sqlite
        'username' => 'xbackbone', // null, if sqlite
        'password' => 's3cr3t', // null, if sqlite
    ),
);

LDAP Authentication

Since the release 3.1, the LDAP integration can be configured.

Edit the config.php, and add the following lines: This configuration requires anonymous LDAP access

return array(
    ...
    'ldap' => array(
        'enabled' => true, // enable it
        'host' => 'ad.example.com', // set the ldap host
        'port' => 389, // ldap port
        'base_domain' => 'dc=example,dc=com', // the base_dn string
        'user_domain' => 'ou=Users', // the user dn string
        'rdn_attribute' => 'uid=', // the attribute to identify the user
    ),
);

The following configuration snippet enables authenticated LDAP user lookups

return array(
    ...
    'ldap' => array(
        'enabled' => true, // enable it
        'schema' => 'ldap', // use 'ldap' or 'ldaps' Default is 'ldap'
        'host' => 'ad.example.com', // set the ldap host
        'port' => 389, // ldap port
        'base_domain' => 'dc=example,dc=com', // the base_dn string
        'search_filter' => '(&(objectClass=user)(sAMAccountName=????))', // ???? is replaced with user provided username
        'rdn_attribute' => 'sAMAccountName', // the attribute to use as username
        'service_account_dn' => 'cn=xbackbone,cn=Users,dc=example,dc=com', // LDAP Service Account Full DN
        'service_account_password' => 'examplepassword',
    ),
);

Enabling LDAP over TLS. Make sure to update port number. Merge with your current LDAP configuration.

return array(
    ...
    'ldap' => array(
    	'schema' => 'ldaps',  //defaults to 'ldap'
    	'port' => 636, 
    ),
);

Enabling StartTLS upgrade. Merge with your current LDAP configuration.

return array(
    ...
    'ldap' => array(
    	...
    	'useStartTLS' => true,  //defaults to false 
    ),
);

The 'schema' => 'ldaps' and 'useStartTLS'=> true configuration directives are mutually exclusive. Do no use them together.

By activating this function, it will not be possible for users logging in via LDAP to reset the password from the application (for obvious reasons), and it will also be possible to bring existing users under LDAP authentication.

Storage drivers

XBackBone supports these storage drivers (with some configuration examples):

• Local Storage (default)

return array(
    ...
    'storage' => array (
        'driver' => 'local',
        'path' => '/path/to/storage/folder',
    ),
);

• Amazon S3

return array(
    ...
    'storage' => array (
        'driver' => 's3',
        'key' => 'the-key',
        'secret' => 'the-secret',
        'region' => 'the-region',
        'bucket' => 'bucket-name',
        'path' => 'optional/path/prefix',
    ),
);

For any filesystem S3-compatible, it's possible to specify an endpoint (for i.e. Minio)

return array(
    ...
    'storage' => array (
        'driver' => 's3',
        'endpoint' => 'my-custom-endpoint',
        'key' => 'the-key',
        'secret' => 'the-secret',
        'region' => 'the-region',
        'bucket' => 'bucket-name',
        'path' => 'optional/path/prefix',
    ),
);

• Dropbox

return array(
    ...
    'storage' => array (
        'driver' => 'dropbox',
        'token' => 'the-token',
    ),
);

• FTP(s)

return array(
    ...
    'storage' => array (
        'driver' => 'ftp',
        'host' => 'ftp.example.com',
        'port' => 21,
        'username' => 'the-username',
        'password' => 'the-password',
        'path' => 'the/prefix/path/',
        'passive' => true/false,
        'ssl' => true/false,
    ),
);

• Google Cloud Storage

return array(
    ...
    'storage' => array (
        'driver' => 'google-cloud',
        'project_id' => 'the-project-id',
        'key_path' => 'the-key-path',
        'bucket' => 'bucket-name',
    ),
);

• Azure Blob Storage

return array(
    ...
    'storage' => array (
        'driver' => 'azure',
        'account_name' => 'the-storage-account-name',
        'account_key' => 'the-account-key',
        'container_name' => 'container-name',
    ),
);

Changing themes

XBackBone supports all bootswatch.com themes.

From the web UI:

• Navigate to the web interface as admin -> System Menu -> Choose a theme from the dropdown.

From the CLI:

• Run the command php bin/theme to see the available themes.
• Use the same command with the argument name (php bin/theme <THEME-NAME>) to choose a theme.
• If you want to revert back to the original bootstrap theme, run the command php bin/theme default.

Clear the browser cache once you have applied.

Change app install name

Add to the config.php file an array element like this:

return array(
    'app_name' => 'This line will overwrite "XBackBone"',
    ...
);