Frequently asked questions

This page contain the answer to the most frequent questions from community users organised by topics.

General topics

What is Bacula-Web ?

Bacula-Web goal is to provide a reporting and monitoring solution for your Bacula backup infrastructure. It provides useful information about Bacula Jobs, Pools, Volumes, clients, etc.

How much does Bacula-Web cost ? Is it free of charge ?

Do I need to pay anything to use it ?

Nope, I’m glad to say that Bacula-Web, as an open source project, can be downloaded and used without any costs, and it always will be.

What about the license ?

Unless it’s clearly written, Bacula-Web project source code, documentations, logo, website, etc. are released under the terms of GPLv2 (for more details, see LICENSE)

Does Bacula-Web supports any web browser ?

As far as I know, Bacula-Web there is no known compatibility issue with any recent web browser.

Bacula-Web works without problem using latest version of Chrome, Firefox, Brave (used during development process).

If you would like to share some feedback using a specific one, don’t hesitate to share your experience with any other web browser by giving to a feedback.

The only thing you’ve to worry about is to make sure that Javascript is not disabled.

Which version of Bacula are supported ?

You can use Bacula-Web with any version of Bacula.

Note

You may face problems while using really old or latest versions of Bacula.

If you face any problem, feel free to submit a bug report and I’ll do my best to help you or make a bug fix.

Which Bacula catalog database engine are supported by Bacula-Web ?

As of current version of Bacula-Web (version 9.4.0), Bacula catalog running with MySQL, MariaDB and postgreSQL are supported.

Important

Support for SQLite Bacula catalog was removed on version v9.4.0

On which OS can I install Bacula-Web ?

Bacula-Web is currently developed and tested under Centos 6 and Red Hat EL version 5.

But it should work fine on your preferred Linux distributions as

  • Debian / Ubuntu (any deb based Linux OS)

  • Fedora / Centos / Rocky Linux / AlmaLinux / Oracle Linux (any rpm based Linux OS)

  • Gentoo

  • Slackware

  • OpenSuse

I’ve never tried running Bacula-Web on MS Windows using XAMPP or WampServer, but I don’t see anything blocking users to do it.

In case you need further help, don’t hesitate to get back to me by mail (bacula-dev at dflc dot ch)

What’s the current status of Bacula-Web ?

As described in the About the project section, I revived the Bacula-Web project since end of 2010 after few years without bug fixes and improvements, and a lot of effort has been made a provide more stable, secure and useful tool, with the precious help from the community.

So what is the current status ?

Despite the fact that I think there’s still a lot to potential improvements, latest released version is stable and bug free.

Why reviving Bacula-Web project ?

Since several years, I’m using as you this amazing open source backup tool Bacula and I was looking for a web based tool that provide me useful information about last night jobs.

My first look were on WeBacula and bweb which are nice to use and features full but maybe pretty much not easy to install and configure.

Then, I’ve found Bacula-Web which wasn’t patched and updated since many years.

I submitted patches to Bacula developer list and after some commit, i proposed to become the official maintainer of this project. That’s was on July 2010.

I know that there’s a lot of web based console for managing, monitoring and configuring bacula like

  • bweb

  • bat

  • Webacula

You can also find a complete list of GUI in the Bacula’s web site

Because bacula-web stand to be (for both next patch and future release)

  • Really easy to install, configure and upgrade

  • Easy to use (after you’ve successfully installed, you just need a web browser, no GUI)

  • Useful (see roadmap for the next version’s coming)

I do use Bacula-Web for personal usage several time per week, and the idea was simply to share those improvements with the community

  • Fixes and enhancement I’ve created on my side

  • Added features such as a new test page

  • Improved design

  • Fixed some SQL query bugs (MySQL and postgreSQL)

Installation

What are the requirements to use Bacula-Web on my server ?

A full list of requirements is documented in the documentation section.

Which version of PHP is supported ?

As of Bacula-Web version 9.0.0, the required PHP version is version <= 8.0

Important

PHP versions prior to 8.0 are EOL, theses versions no longer have security support and are exposed to non patched security vulnerabilities.

For more details, please have a look at the currently supported PHP version (PHP.net website)

Where can I download latest version of Bacula-Web ?

Even I would love too, unfortunately, there’s no rpm or deb binary package available (yet).

I used to publish a “package” provided which were available in each releases GitHub release notes

But as it was causing more issues than really helping users, I decided to stop publishing this “package” (which consists only of pre-installed Composer dependencies).

But, I may think again about this for a future major version.

Support

How can I submit a bug and features report ?

Bugs and feature requests are tracked using GitHub issues.

Hint

You can find more information on how to submit a bug report here

Troubleshooting

After installing Bacula-Web, I only get a blank page, what could be wrong ?

First, ensure that running the test page, everything is ok (use the example link below)

http://yourserver/bacula-web/test

Make sure Composer dependencies are correctly installed by running this command from the root of Bacula-Web installation folder

$ composer check

The output should not contain any errors/warnings from Composer

Also, make sure you ran Bacula-Web console check tool

$ sudo -u www-data php bwc check

The output should not contain any error / warning

If above instructions didn’t help, then you can get some help by creating an issue on the GitHub project

Why I can’t connect to remote db server with SELinux enforced ?

If you gave right permissions and access to your database user, I guess that SELinux is the problem

Check your log file (/var/log/audit/audit.log on RedHat/Centos) for the error below

type=AVC msg=audit(1346832664.222:2491): avc:  denied  { name_connect } for  pid=3427 comm="httpd" dest=3306 scontext=unconfined_u:system_r:httpd_t:s0 tcontext=system_u:object_r:mysqld_port_t:s0 tclass=tcp_socket
type=SYSCALL msg=audit(1346832664.222:2491): arch=40000003 syscall=102 success=no exit=-13 a0=3 a1=bfb94dd0 a2=b63d80c0 a3=c items=0 ppid=3421 pid=3427 auid=0 uid=48 gid=48 euid=48 suid=48 fsuid=48 egid=48 sgid=48 fsgid=48 tty=(none) ses=32 comm="httpd" exe="/usr/sbin/httpd" subj=unconfined_u:system_r:httpd_t:s0 key=(null)

and disable SELinux on your server

$ sudo setenforce permissive

or

$ sudo setenforce disabled

* :ref:`Does Bacula-Web can run on a system having SELinux enforced ?<troubleshoot-selinux-enforced>`

Does Bacula-Web can run on a system having SELinux enforced ?

Short answer, Yes

If you are facing issues while using SELinux in enforced mode, make sure bacula-web files and folders must have the correct SELinux context.

Assuming you have installed the files in this directory

/var/www/html/bacula-web

you can fix the SELinux context by running the command below

$ sudo chcon -t httpd_sys_content_t /var/www/html/bacula-web/ -R

Otherwise, the simplest would be to set SELinux to Permissive or Disabled

Support the project

Note

If you find Bacula-Web useful and would like to encourage the project’s efforts, Then I’d be happy to see you part of the list of bakers. Use this link if you want to know more about it.