Themes: Install ¶

This section outlines how to install custom themes that are included in the Github repository. These themes will override your existing ConfigServer Firewall theme, so be aware that you will be unable to utilize the default light theme unless you back up the original files and add them back.

Available Themes¶

We offer the following custom themes:

Dark theme login page — Dark theme preview

Install¶

Head over to the Releases page and download the theme zip file:

*-theme-dark.zip

Extract the files from the zip to the same paths as they are shown in the zip. You should have the following files:

Backup Data

It is recommended that you back up your current copy of ConfigServer Firewall before overwriting the files with the custom theme files.

/etc/csf/ui/images/*.css
/usr/local/csf/lib/ConfigServer/*.pm
/usr/sbin/lfd

After you have copied over the new files from the zip, give ConfigServer Firewall a restart using the command:

sudo csf -ra

Once ConfigServer Firewall is restarted, you should be able to open your browser and navigate to your firewall's normal URL address and see the new theme.

Uninstall¶

Currently, there is no uninstaller available for custom themes. In order to remove your custom theme, you must restore the original ConfigServer Firewall theme files that come with the official version. These are located in the following paths:

/etc/csf/ui/images/*.css
/usr/local/csf/lib/ConfigServer/*.pm
/usr/sbin/lfd