Configuration Backup

The backup/restore feature lets you take a snapshot of all the configuration files and save them to a separate system for safe keeping. If a ClearOS system needs to be restored, you can re-install the ClearOS system and then restore all the configuration settings from the backup.


This feature is part of the core system and installed by default.

You can find this feature in the menu system at the following location:

<navigation>System|Backup|Configuration Backup and Restore </navigation>

Remote Server Backup and ClearSDN

The backup/restore settings tool does not save user data, logs or mailboxes. Use Remote Server Backup to keep your data safe. The remote server backup system is able to backup MySQL databases, mail stores, LDAP, file shares as well as specified files and directories. The solution takes all the complexity out of doing a backup and protects vital data from being lost.


There are no configurable options for this app

The backup/restore tool saves a rolling 10 days of all the configuration information available through webconfig including:

  • Usernames and passwords
  • Network configuration
  • Firewall configuration
  • Software configuration (for example, content filter)

If you have installed third party applications on your system, you will need to take extra steps to save configuration data.

The backup is created automatically overnight.

Restore From Archive

At the moment there is a problem restoring an Active Directory Connector configuration into a fresh installation ClearOS7. In order for it to work correctly you must install the Windows Networking (Samba) app from the Marketplace before you do the configuration restore. If you do not do this you will need to reinstall from scratch. Installing the Windows Networking (Samba) app after a config restore then doing another config restore does not fix the problem.
You may then need to start winbind and set it to restart automatically on boot:
systemctl start winbind.service
systemctl enable winbind.service

If you still have problems please consult the Active Directory Connector Troubleshooting guide, especially the “wbinfo -t” section.

If restoring to a different machine, it is probably a good idea to block the restore program from updating /etc/clearos/network.conf or you will need to go to the console to reset your network connections:
chattr +i /etc/clearos/network.conf

After the restore, remember to unblock changes to the file:

chattr +i /etc/clearos/network.conf

This allows you to restore a backup from any location accessible from your desktop.


This lists the last 10 archives which are still available on the server.

The Backup Now button allows you to manually create a backup.

The Download button allows you to download a backup to any location accessible from your desktop. You may want to do this if you want to keep more than the 10 rolling copies.

The Restore button allows you to restore the selected backup from the file held on the server.

The Delete button allows you to delete the selected backup from the server.

If you are restoring a backup onto a new machine, it is very likely that the network interfaces have changed. You must purge any interface names not valid on your new machine from the EXTIF, LANIF, HOTIF and DMZIF fields in /etc/clearos/network.conf, and any firewall rules relating to invalid interfaces from /etc/clearos/firewall.conf and /etc/clearos/qos.conf1 (the QOS_PRIOMARK4 section). Also clean up /etc/clearos/dynamic_vpn.conf1 and /etc/clearos/multiwan.conf1.

1 - These files may not exist if you don't have the relevant apps installed

Command line restore

It is possible to do a command line restore following the instructions in the Knowledgebase article Restore Configuration Backup from Command Line.


During the restore procedure, the original network settings will be restored, but not activated. Consider this scenario:

  • The system settings on a live ClearOS gateway have been saved.
  • Due to a hard disk failure, ClearOS was temporarily replaced with a basic router.
  • ClearOS was re-installed on another server while connected to your LAN.
  • The restore procedure is then used on the newly installed ClearOS system.

The network settings are now in limbo. The restored network configuration is expecting to be connected as a gateway, but the system is temporarily running as a standalone system on your LAN. In this scenario, you will either need to put the system back into its role as a gateway, or, reconfigure the network.

If you restore into a new machine, almost certainly your Network Interface names will change so you will need to set them up again. You will need to re-input the 1-to-1 NAT, Network, DHCP Server and ibVPN settings and, possibly, the Radius settings.


content/en_us/7_ug_configuration_backup.txt · Last modified: 2020/11/24 11:37 by