Configuration Backup

Zentyal configuration Backup

Zentyal offers a configuration backup service, to ensure the recovery of a server when a disaster occurs, for example a hard disk failure or a human error while managing configurations.


This backup only contains the configuration of the modules, the data must be copy manually or through Backup

Backups can be made locally, saving them on the local hard drive of the Zentyal host. After this, it is recommended to save them to an external physical system, so if the machine suffers a failure, you still have access to this data. The backup files are stored in /var/lib/zentyal/conf/backups/

To access the backup options, go to System ‣ Import/Export configuration. You can not backup if there are unsaved changes in the configuration.


Making a configuration backup

Once you have entered the Name for the backup and clicked on Backup, you will see a window which will show the progress of the different modules until the message Backup successfully completed is displayed.

Afterwards, if you return to the former window, you can see in the bottom of the page a Backups list. Using this list you can restore, download to a client disk or delete any of the saved copies. Additionally, you will have data about the creation date and size.

In the Restore backup from a file section you can send a security copy file that you have previously created, for example, associated with a former Zentyal server installation in another host and restore it using Restore. You will be asked for confirmation; simply remember to be careful, as the current configuration will be completely overwritten.

The restoration process is similar to the copy; after showing the progress, the user will be notified with a success message if there is no error.


You can use the /usr/share/zentyal/restore-backup script to restore the settings of each one of the Zentyal modules individually or a group of modules.


Note that this feature, although not disabled, can not be used to restore the configuration of those servers that have been configured as additional domain controllers.

Considerations when restoring a configuration backup

If you need to restore a configuration backup in a fresh install, because of a disaster or hardware change, you must take into account the following considerations before proceeding to import the configuration backup:

  • The Zentyal version has to be the same on both of the servers.
  • The hostname and the domain name have to be previously configured in the new server.
  • The new server has to have (at least) the same number of network interfaces and at least one of them has to be enabled.
  • The new server has to have the same modules installed.
  • If you have the Domain Controller module configured, you must enable it first.
  • If you have the Mail and/or Webmail modules configured, you must enable them first.


For the last two cases, enabling the modules with the default settings will be enough to be able to import the configuration backup successfully.