Configure Bacula-Web

This section explain how to create the configuration file which contain your custom settings.

Note

Please note that since version 5.1.0, the config file is a PHP script (it was a .conf file before this version).

Create configuration file

Bacula-Web settings are stored in the file below

application/config/config.php

From Bacula-Web root folder, copy the sample config file and give it the name config.php

# cd application/config
# cp -v config.php.sample config.php

Now you need to make sure config.php has the correct permissions.

The configuration file needs to be at least readable by the user owning the web server process.

On Red Hat / Centos / Fedora, the user running Apache is apache

On Debian / Ubuntu, the user running Apache is www-data

So depending on which system you have installed Bacula-Web, run the command below

# chown -v <apache_user>: config.php

For example, on Debian Jessie, use this command

# chown -v www-data: config.php

on Centos 7

# chown -v apache: config.php

Note

Do not forget the column <:> after apache_user

Settings

General settings

Setting

Description

Default value

$config[‘language’]

Set displayed language

en_US

$config[‘hide_empty_pools’]

Hide empty pools

true

$config[‘show_inactive_clients’]

Show inactive clients or not

true

$config[‘datetime_format’]

Change default date and time format

Y-m-d H:i:s

$config[‘datetime_format_short’]

Change default short date and time format

Generated from above datetime_format

$config[‘enable_users_auth’]

Enable or disable users authentication

true

$config[‘rows_per_page’]

Rows per pagination page

25

$config[‘debug’]

Enable or disable debug mode

false

$config[‘basepath’]

Set base path

empty

language

Description

As Bacula-Web is translated into not less than 15 languages, the language setting allow you to change the displayed language of Bacula-Web.

You can simply change from the default english (en_US), to your language by setting the $config[‘language’] parameter value.

Example

$config['language'] = 'pt_BR'; // For portuguese brazilian

Note

Important note

Before changing default language, please make sure the locale is available. To verify this you can run this command on the server running Bacula-Web.

$ locale -a

also make sure you’ve restarted Apache/Nginx service.

hide_empty_pools

Description

Do not display empty pools in Dashboard (Pools and volumes widget)

Example

$config['hide_empty_pools'] = false;

Note

this setting is available since Bacula-Web 5.2.11

show_inactive_clients

Description

If disabled (set to false), don’t list or show inactive clients

Example

$config['show_inactive_clients'] = true;

Note

this setting is available since Bacula-Web 5.2.11

datetime_format

Description

Define your custom date & time format (by default Y-m-d H:i:s)

For more information on date format, have a look on date() function in PHP manual

Example

$config['datetime_format'] = 'd/m/Y H:i:s';
or
$config['datetime_format'] = 'm-d-Y H:i:s';

Note

this setting is available only since version 7.4.0

datetime_format_short

description

Define your custom short date & time format

This config parameter is optional (commented out by default in config.php.sample) The default value is generated from datetime_format config parameter.

For more information on date format, have a look on date() function in PHP manual

Example

$config['datetime_format_short'] = 'd/m/Y';

enable_users_auth

Description

Enable or disable users authentication.

This settings is useful if you already authenticate users on Web server side, using .htpasswd or LDAP authentication (mod_auth_ldap or any other).

Example

// By default, users authentication is enabled
$config['enable_users_auth'] = true;

// Disable it using config below
$config['enable_users_auth'] = false;

Important

Use this settings with caution, don’t disable users authentication unless you already authenticated users.

rows_per_page

Description

Define how many rows per pagination page will be displayed.

Example

$config['rows_per_page'] = 25;

Note

This setting is available since version 8.5.0

debug

Description

Enable or disable debug mode

Debug mode could be helpful to troubleshoot Bacula-Web setup problem. Debug mode is disabled by default

Example

// Enable debug mode
$config['debug'] = true;

Important

Use debug mode with caution, sensitive information can be disclosed if your Bacula-Web setup is exposed to unsecure network.

basepath

Description

Uncomment this config parameter only if you are using Apache mod_alias and have setup Bacula-Web in a sub-folder (eg: http://yourhost/bacula-web)

This config parameter is commented by default in config.php.sample, comment it out only if needed.

Example

// Important: Do not forget the starting slash (/)
$config['basepath'] = '/bacula-web';

Note

This setting is available since version 9.1.0

Database connection settings

Each Bacula catalog (database) needs to be defined using the settings below

Setting

Description

Example

label

label displayed in the catalog drop-down selector

Backup server

host

hostname of the db server hosting Bacula catalog

localhost, fqdn host or ip address

db_name

name of the catalog database name

usually bacula, unless you changed it

login

database user

bacula, admin, etc.

password

database password

mK3DQLolUV

db_type

database type

mysql, pgsql

db_port

database port number

  • mysql, use 3306

  • pgsql, use 5432

Examples

Single MySQL Bacula catalog

// Bacula catalog label (used for catalog selector)
$config[0]['label'] = 'Backup Server';

// Server
$config[0]['host'] = 'localhost';

// Database name
$config[0]['db_name'] = 'bacula';

// Database user
$config[0]['login'] = 'bacula';

// Database user's password
$config[0]['password'] = 'verystrongpassword';

// Database type (mysql | pgsql)
$config[0]['db_type'] = 'mysql';

// Database port
$config[0]['db_port'] = '3306';

Multiple catalogs (example)

<?php
//MySQL bacula catalog
$config[0]['label'] = 'Backup Server';
$config[0]['host'] = 'localhost';
$config[0]['login'] = 'bacula';
$config[0]['password'] = 'verystrongpassword';
$config[0]['db_name'] = 'bacula';
$config[0]['db_type'] = 'mysql';
$config[0]['db_port'] = '3306';

//PostgreSQL Lab server
$config[1]['label'] = 'Lab backup server';
$config[1]['host'] = '192.168.0.120';
$config[1]['login'] = 'bacula';
$config[1]['password'] = 'verystrongpassword';
$config[1]['db_name'] = 'bacula';
$config[1]['db_type'] = 'pgsql';
$config[1]['db_port'] = '5432';
?>

Full configuration example

Full config.php example

<?php
// Language
$config[0]['language'] = 'en_US';

// Show inactive clients
$config['show_inactive_clients'] = false;

// Hide empty pools
$config['hide_empty_pools'] = true;

//MySQL bacula catalog
$config[0]['label'] = 'Backup Server';
$config[0]['host'] = 'localhost';
$config[0]['login'] = 'baculaweb';
$config[0]['password'] = 'password';
$config[0]['db_name'] = 'bacula';
$config[0]['db_type'] = 'mysql';
$config[0]['db_port'] = '3306';

// PostgreSQL bacula catalog
$config[1]['label'] = 'Prod Server';
$config[1]['host'] = 'db-server.domain.com';
$config[1]['login'] = 'bacula';
$config[1]['password'] = 'otherstrongpassword';
$config[1]['db_name'] = 'bacula';
$config[1]['db_type'] = 'pgsql';
$config[1]['db_port'] = '5432';

Warning

If you define several Bacula catalog, make sure each catalog connection settings have a different id example: $config[0], $config[1], etc.