Import and Exporting Settings

Sometimes you need to be able to import and export Admin Tools it. Some indicative use cases are:

  • Backing up your Admin Tools settings before trying massive changes which could break your configuration

  • Transferring your settings to another site on the same or an identical server

  • Copying the IP white- and black-lists or email templates

You can do that through the Export Settings and Import Settings pages of the component.

[Warning]Warning

Exporting and importing very large datasets (more than a thousand rows) IS NOT RECOMMENDED and CAN LEAD TO TIMEOUT ERRORS. This is a limitation of PHP, namely the memory_limit (maximum memory usage limit) and max_execution_time (maximum time to execute the page) imposed by your server's php.ini. Besides, it is a very bad idea having so many IP white-/black-list and/or email template rows as your site's performance would suffer. If you find yourself putting more than 100 records into these features you probably need to rethink your approach.

Exporting Settings

In this page you can choose which settings you want to export. The available options are:

WAF configuration

This includes all settings in the Configure WAF, .htaccess Maker, NginX Configuration Maker and Web.Config Maker pages.

[Warning]Warning

These also include the domain names you have set up in the Allowed Domains (in Web Application Firewall) and the HTTP and HTTPS hosts (in the .htaccess Maker, NginX Configuration Maker and Web.Config Maker pages). When importing to a different site please make sure to go through these settings as well as any other settings which many reference server– or site–specific configuration to prevent getting locked out of your site.

WAF Deny List

This includes all entries of the WAF Deny List page.

WAF Exceptions

This includes all entries of the WAF Exceptions List page.

IP Disallow List

The permanently disallowed IP addresses from the IP Disallow List page

Exclusive Allow IP List

The allowed administrator IP addresses from the Exclusive Allow IP List page

Bad Words

This includes all entries of the Bad Words page.

User Agents to Block

This only includes the Blocked User Agents in the .htaccess Maker, NginX Configuration Maker and Web.Config Maker pages.

After selecting what you want to export click on the Export settings button in the toolbar. Your browser will download a JSON file with all of the selected configuration settings.

[Note]Note

It goes without saying that you should select at least one of these export options. Otherwise you will be downloading an essentially empty file that does nothing upon import.

Importing Settings

Choose the exported JSON file and click on the Import settings button in the toolbar. The imported settings will overwrite your existing settings.