// Tutorial //

How To Back Up a CentOS 7 Server with Bacula

Published on April 13, 2015
Default avatar
By Mitchell Anicas
Developer and author at DigitalOcean.
How To Back Up a CentOS 7 Server with Bacula


This tutorial will show you how to set up Bacula to create backups of a remote CentOS 7 host, over a network connection. This involves installing and configuring the Bacula Client software on a remote host, and making some additions to the configuration of an existing Bacula Server (covered in the prerequisites).

If you are trying to create backups of Ubuntu 14.04 hosts, follow this link instead: How To Back Up an Ubuntu 14.04 Server with Bacula.


This tutorial assumes that you have a server running the Bacula Server components, as described in this link: How To Install Bacula Server on CentOS 7.

We are also assuming that you are using private network interfaces for backup server-client communications. We will refer to the private FQDN of the servers (FQDNs that point to the private IP addresses). If you are using IP addresses, simply substitute the connection information where appropriate.

For the rest of this tutorial, we will refer to the Bacula Server as “BaculaServer”, “Bacula Server”, or “Backup Server”. We will refer to the remote host, that is being backed up, as “ClientHost”, “Client Host”, or “Client”.

Let’s get started by making some quick changes to the Bacula Server configuration.

Organize Bacula Director Configuration (Server)

On your Bacula Server, perform this section once.

When setting up your Bacula Server, you may have noticed that the configuration files are excessively long. We’ll try and organize the Bacula Director configuration a bit, so it uses separate files to add new configuration such as jobs, file sets, and pools.

Let’s create a directory to help organize the Bacula configuration files:

  1. sudo mkdir /etc/bacula/conf.d

Then open the Bacula Director configuration file:

  1. sudo vi /etc/bacula/bacula-dir.conf

At the end of the file add, this line:

bacula-dir.conf — Add to end of file
@|"find /etc/bacula/conf.d -name '*.conf' -type f -exec echo @{} \;"

Save and exit. This line makes the Director look in the /etc/bacula/conf.d directory for additional configuration files to append. That is, any .conf file added in there will be loaded as part of the configuration.

Add RemoteFile Pool

We want to add an additional Pool to our Bacula Director configuration, which we’ll use to configure our remote backup jobs.

Open the conf.d/pools.conf file:

  1. sudo vi /etc/bacula/conf.d/pools.conf

Add the following Pool resource:

conf.d/pools.conf — Add Pool resource
Pool {
  Name = RemoteFile
  Pool Type = Backup
  Label Format = Remote-
  Recycle = yes                       # Bacula can automatically recycle Volumes
  AutoPrune = yes                     # Prune expired volumes
  Volume Retention = 365 days         # one year
    Maximum Volume Bytes = 50G          # Limit Volume size to something reasonable
  Maximum Volumes = 100               # Limit number of Volumes in Pool

Save and exit. This defines a “RemoteFile” pool, which we will use by the backup job that we’ll create later. Feel free to change any of the parameters to meet your own needs.

We don’t need to restart Bacula Director just yet, but let’s verify that its configuration doesn’t have any errors in it:

  1. sudo bacula-dir -tc /etc/bacula/bacula-dir.conf

If there are no errors, you’re ready to continue on to the Bacula Client setup.

Install and Configure Bacula Client

Perform this section on any Client Host that you are adding to your Bacula setup.

Then install the bacula-client package:

  1. sudo yum install bacula-client

This installs the Bacula File Daemon (FD), which is often referred to as the “Bacula client”.

Configure Client

Before configuring the client File Daemon, you will want to look up the following information, which will be used throughout the remainder of this tutorial:

  • Client hostname:: Our example will use “ClientHost”
  • Client Private FQDN: We’ll refer to this as “client_private_FQDN”, which may look like clienthost.private.example.com
  • Bacula Server hostname: Our example will use “BackupServer”

Your actual setup will vary from the example, so be sure to make substitutions where appropriate.

We will need to set a password, that will allow the Bacula Director to connect, in the File Daemon configuration. Let’s generate a random password now (or you can skip this step and make up your own password):

date +%s | sha256sum | base64 | head -c 33 ; echo

You will want to copy the output, as you will use it in the next step.

Open the File Daemon configuration:

  1. sudo vi /etc/bacula/bacula-fd.conf

We need to change a few items and save some information that we will need for our server configuration.

Begin by finding the Director resource that is named “ClientHost-dir”. As the Bacula Director that we want to control this Client is located on the Bacula Server, change the “Name” parameter to the hostname of your backup server followed by “-dir”. Also, replace the existing password with the one you generated in the previous step. It should look something like this after being updated:

bacula-fd.conf — Update Director Name and Password
Director {
  Name = BackupServer-dir
  Password = "Y2Q5ODUyMWM0YTFhYjA3NTcwYmU5OTA4Y"

Be sure to keep the password handy. It will be used in the Backup Server’s Director configuration, which we will set in an upcoming step, to connect to your Client’s File Daemon.

Next, we need to adjust one parameter in the FileDaemon resource. We will change the FDAddress parameter to match the private FQDN of our client machine. The Name parameter should already be populated correctly with the client file daemon name. The resource should looks something like this (substitute the actual FQDN or IP address):

bacula-fd.conf — Update Name and Add FDAddress
FileDaemon {                          # this is me
  Name = ClientHost-fd
  FDAddress = client_private_ip
  FDport = 9102                  # where we listen for the director
  WorkingDirectory = /var/spool/bacula
  Pid Directory = /var/run
  Maximum Concurrent Jobs = 20

We also need to configure this daemon to pass its log messages to the Backup Server. Find the Messages resource and change the director parameter to match your backup server’s hostname with a “-dir” suffix. It should look something like this:

bacula-fd.conf — Update director
Messages {
  Name = Standard
  director =  BackupServer-dir = all, !skipped, !restored

Save the file and exit. Your File Daemon (Bacula Client) is now configured to listen for connections over the private network.

Check that your configuration file has the correct syntax with the following command:

  1. sudo bacula-fd -tc /etc/bacula/bacula-fd.conf

If the command returns no output, the configuration file has valid syntax. Restart the file daemon to use the new settings:

  1. sudo systemctl restart bacula-fd

Then run the following command to start the Bacula File Daemon automatically on boot:

sudo systemctl enable bacula-fd

Let’s set up a directory that the Bacula Server can restore files to. Create the file structure and lock down the permissions and ownership for security with the following commands:

  1. sudo mkdir -p /bacula/restore
  2. sudo chown -R bacula:bacula /bacula
  3. sudo chmod -R 700 /bacula

The client machine is now configured correctly. Next, we will configure the Backup Server to be able to connect to the Bacula Client.

Add FileSets (Server)

A Bacula FileSet defines a set of files or directories to include or exclude files from a backup selection, and are used by backup jobs on the Bacula Server.

If you followed the prerequisite tutorial, which sets up the Bacula Server components, you already have a FileSet called “Full Set”. If you want to run Backup jobs that include almost every file on your Backup Clients, you can use that FileSet in your jobs. You may find, however, that you often don’t want or need to have backups of everything on a server, and that a subset of data will suffice.

Being more selective in which files are included in a FileSet will decrease the amount of disk space and time, required by your Backup Server, to run a backup job. It can also make restoration simpler, as you won’t need to sift through the “Full Set” to find which files you want to restore.

We will show you how to create new FileSet resources, so that you can be more selective in what you back up.

On your Bacula Server, open a file called filesets.conf, in the Bacula Director configuration directory we created earlier:

  1. sudo vi /etc/bacula/conf.d/filesets.conf

Create a FileSet resource for each particular set of files that you want to use in your backup jobs. In this example, we’ll create a FileSet that only includes the home and etc directories:

filesets.conf — Add Home and Etc FileSet
FileSet {
  Name = "Home and Etc"
  Include {
    Options {
      signature = MD5
      compression = GZIP
    File = /home
    File = /etc
  Exclude {
    File = /home/bacula/not_important

There are a lot of things going on in this file, but here are a few details to keep in mind:

  • The FileSet Name must be unique
  • Include any files or partitions that you want to have backups of
  • Exclude any files that you don’t want to back up, but were selected as a result of existing within an included file

You can create multiple FileSets if you wish. Save and exit, when you are finished.

Now we’re ready to create backup job that will use our new FileSet.

Add Client and Backup Job to Bacula Server

Now we’re ready to add our Client to the Bacula Server. To do this, we must configure the Bacula Director with new Client and Job resources.

Open the conf.d/clients.conf file:

  1. sudo vi /etc/bacula/conf.d/clients.conf

Add Client Resource

A Client resource configures the Director with the information it needs to connect to the Client Host. This includes the name, address, and password of the Client’s File Daemon.

Paste this Client resource definition into the file. Be sure to substitute in your Client hostname, private FQDN, and password (from the Client’s bacula-fd.conf), where highlighted:

conf.d/clients.conf — Add Client resource
Client {
  Name = ClientHost-fd
  Address = client_private_FQDN
  FDPort = 9102 
  Catalog = MyCatalog
  Password = "Y2Q5ODUyMWM0YTFhYjA3NTcwYmU5OTA4Y"          # password for Remote FileDaemon
  File Retention = 30 days            # 30 days
  Job Retention = 6 months            # six months
  AutoPrune = yes                     # Prune expired Jobs/Files

You only need to do this once for each Client.

Create a backup job:

A Backup job, which must have a unique name, defines the details of which Client and which data should be backed up.

Next, paste this backup job into the file, substituting the Client hostname for the highlighted text:

conf.d/clients.conf — Add Backup job resource
Job {
  Name = "BackupClientHost"
  JobDefs = "DefaultJob"
  Client = ClientHost-fd
  Pool = RemoteFile
  FileSet="Home and Etc"

This creates a backup job called “BackupClientHost”, which will back up the home and etc directories of the Client Host, as defined in the “Home and Etc” FileSet. It will use the settings specified in the “DefaultJob” JobDefs and “RemoteFile” Pool resources, which are both defined in the main bacula-dir.conf file. By default, jobs that specify JobDefs = "DefaultJob" will run weekly.

Save and exit when you are done.

Verify Director Configuration

Let’s verify that there are no syntax errors in your Director configuration file:

  1. sudo bacula-dir /etc/bacula/bacula-dir.conf

If you are returned to the shell prompt, there are no syntax errors in your Bacula Director’s configuration files.

Restart Bacula Director

To put the configuration changes that you made into effect, restart Bacula Director:

  1. sudo systemctl restart bacula-dir

Now your Client, or remote host, is configured to be backed up by your Bacula Server.

Test Client Connection

We should verify that the Bacula Director can connect to the Bacula Client.

On your Bacula Server, enter the Bacula Console:

  1. sudo bconsole
  1. status client
Select Client resource: ClientHost-fd
The defined Client resources are: 1: BackupServer-fd 2: ClientHost-fd Select Client (File daemon) resource (1-2): 2

The Client’s File Daemon status should return immediately. If it doesn’t, and there is a connection error, there is something wrong with the configuration of the Bacula Server or of the Client’s File Daemon.

Test Backup Job

Let’s run the backup job to make sure it works.

On the Bacula Server, while still in the Console, use this command:

  1. run

You will be prompted to select which Job to run. Select the one we created earlier, e.g. “4. BackupClientHost”:

Select Job resource: BackupClientHost
The defined Job resources are: 1: BackupLocalFiles 2: BackupCatalog 3: RestoreLocalFiles 4: BackupClientHost Select Job resource (1-4): 4

At the confirmation prompt, enter “yes”:

Confirmation prompt:
OK to run? (yes/mod/no): yes

Check Messages and Status

After running a job, Bacula will tell you that you have messages. The messages are output generated by running jobs.

Check the messages by typing:

  1. messages

The messages should say “No prior Full backup Job record found”, and that the backup job started. If there are any errors, something is wrong, and they should give you a hint as to why the job did not run.

Another way to see the status of the job is to check the status of the Director. To do this, enter this command at the bconsole prompt:

  1. status director

If everything is working properly, you should see that your job is running or terminated with an “OK” status.

Perform Restore

The first time you set up a new Bacula Client, you should test that the restore works properly.

If you want to perform a restore, use the restore command at the Bacula Console:

  1. restore all

A selection menu will appear with many different options, which are used to identify which backup set to restore from. Since we only have a single backup, let’s “Select the most recent backup”—select option 5:

Select item (1-13):

Then you must specify which Client to restore. We want to restore the remote host that we just set up, e.g. “ClientHost-fd”:

Select the Client: ClientHost-fd
Defined Clients: 1: BackupServer-fd 2: ClientHost-fd Select the Client (1-2): 2

This will drop you into a virtual file tree with the entire directory structure that you backed up. This shell-like interface allows for simple commands to mark and unmark files to be restored.

Because we specified that we wanted to “restore all”, every backed up file is already marked for restoration. Marked files are denoted by a leading * character.

If you would like to fine-tune your selection, you can navigate and list files with the “ls” and “cd” commands, mark files for restoration with “mark”, and unmark files with “unmark”. A full list of commands is available by typing “help” into the console.

When you are finished making your restore selection, proceed by typing:

  1. done

Confirm that you would like to run the restore job:

OK to run? (yes/mod/no):

Check Messages and Status

As with backup jobs, you should check the messages and Director status after running a restore job.

Check the messages by typing:

  1. messages

There should be a message that says the restore job has started or was terminated with an “Restore OK” status. If there are any errors, something is wrong, and they should give you a hint as to why the job did not run.

Again, checking the Director status is a great way to see the state of a restore job:

  1. status director

When you are finished with the restore, type exit to leave the Bacula Console:

  1. exit

If everything worked properly, your restored files will be on your Client host, in the /bacula/restore directory. If you were simply testing the restore process, you should delete the contents of that directory.


You now have a Bacula Server that is backing up files from a remote Bacula Client. Be sure to review and revise your configuration until you are certain that you are backing up the correct FileSets, on a schedule that meets your needs. If you are trying to create backups of Ubuntu 14.04 hosts, follow this link: How To Back Up an Ubuntu 14.04 Server with Bacula.

The next thing you should do is repeat the relevant sections of this tutorial for any additional CentOS 7 servers that you want to back up.

Want to learn more? Join the DigitalOcean Community!

Join our DigitalOcean community of over a million developers for free! Get help and share knowledge in our Questions & Answers section, find tutorials and tools that will help you grow as a developer and scale your project or business, and subscribe to topics of interest.

Sign up

Tutorial Series: How To Use Bacula on CentOS 7

This series will show you how implement file backups of your CentOS 7 servers using Bacula, the popular open-source backup software suite.

About the authors
Default avatar
Developer and author at DigitalOcean.

Still looking for an answer?

Was this helpful?


It is very good tutorial. I’ve successfully done Localbackup. But facing issue when try to connect client. After changes everything when I’ve start service as below:

systemctl restart bacula-dir

then it showing below error:

12-Oct 06:20 bacula-dir JobId 0: Fatal error: Unable to authenticate with File daemon at “192.XX.XX.XX:9102”. Possible causes: Passwords or names not the same or Maximum Concurrent Jobs exceeded on the FD or FD networking messed up (restart daemon). Please see http://www.bacula.org/en/rel-manual/Bacula_Freque_Asked_Questi.html#SECTION00260000000000000000 for help.

I’ve cross check it and found that I’ve use same password which I’ve created in client by your providing command.

Same it also not able to connect using bconsole. It showing error as below:

Connecting to Client ClientHost-fd at 192.XX.XX.XX:9102 Failed to connect to Client ClientHost-fd.

So please suggest me what should I check.

Hi, Manicas

I follow your tutorial many times .I have one problem not fix yet. Please help me sir,

The error was , end the paragraph … 26-Jan 16:10 bacula-dir JobId 0: Fatal error: bsock.c:138 Unable to connect to Client: svr2.local.test-fd on ERR=No route to host .

I want to know how to fix it.

26-Jan 15:40 bacula-dir JobId 2: Bacula bacula-dir 5.2.13 (19Jan13): Build OS: x86_64-redhat-linux-gnu redhat (Core) JobId: 2 Job: RestoreLocalFiles.2017-01-26_15.40.03_04 Restore Client: bacula-fd Start time: 26-Jan-2017 15:40:05 End time: 26-Jan-2017 15:40:06 Files Expected: 550 Files Restored: 550 Bytes Restored: 50,321,041 Rate: 50321.0 KB/s FD Errors: 0 FD termination status: OK SD termination status: OK Termination: Restore OK

26-Jan 15:40 bacula-dir JobId 2: Begin pruning Jobs older than 6 months . 26-Jan 15:40 bacula-dir JobId 2: No Jobs found to prune. 26-Jan 15:40 bacula-dir JobId 2: Begin pruning Files. 26-Jan 15:40 bacula-dir JobId 2: No Files found to prune. 26-Jan 15:40 bacula-dir JobId 2: End auto prune.

26-Jan 16:10 bacula-dir JobId 0: Fatal error: bsock.c:138 Unable to connect to Client: svr2.local.test-fd on ERR=No route to host

hi, i need help when i follow the instruction above to setup bacula client on centos 6.8, but when i start the service i got the error:

Starting bacula-fd: Error: Default password in config [Failed]

any help will be appreciated…thanks

Hello, thanks for your tutorials. they are very helpful :) but i got one problem, the server is Ubuntu and the client is Centos 7. i can see the connection but when they try to backup something, on director status i see only this message “is waiting for Client mysql-fd to connect to Storage File”. after 20 minutes is goes to Error.

Please help.


Hi, help me pls. Begin by finding the Director resource that is named “ClientHost-dir”. As the Bacula Director that we want to control this Client is located on the Bacula Server… There no ClientHost-dir. I’m searching in bacula-fd.conf rght?

This comment has been deleted