How to Install and Configure CSF (Config Server Firewall) on CentOS 7 for cPanel/WHM

For more information, see: ConfigServer Security and Firewall (csf) – ConfigServer Services

Config Server Firewall / CSF is firewall application suite for Linux servers. CSF is also a Login/Intrusion Detection for applications like SSH, SMTP, IMAP, Pop3, the “su” command and many more. CSF can e.g. detect when someone is logging into the server via SSH and alarms you when this user tries to use the “su” command on the server to get higher privileges. It also checks for login authentication failures on mail servers (Exim, IMAP, Dovecot, uw-imap, Kerio), OpenSSH servers, Ftp servers (Pure-ftpd, vsftpd, Proftpd), cPanel server to replace software like fail2ban. CSF is a good security solution for hosting servers and can be integrated into the user interface (UI) of WHM/cPanel, DirectAdmin, and Webmin.


  • CentOS 7 (my server uses the IP
  • root privileges.

What we will do in this tutorial:

  • Install the dependencies for CSF.
  • Install CSF.
  • Configure CSF.
  • Basic CSF commands.
  • Advanced Configuration.

Step 1 - Installation of CFS dependencies

CSF is based on Perl, so you need to install Perl on our server first. You need wget to download the CSF installer and vim (or an editor of your choice) for editing the CSF configuration file. Install the packages with the yum command:

yum install wget vim perl-libwww-perl.noarch perl-Time-HiRes

Step 2 - Install CSF

Please go to the “/usr/src/” directory and download CSF with wget command.

cd /usr/src/wget

Extract the tar.gz file and go to the csf directory, then install it:

tar -xzf csf.tgz
cd csfsh

You should get the information that CSF installation is completed at the end.

CSF installation is complete.

Now you should check that CSG really works on this server. Go to the “/usr/local/csf/bin/” directory, and run “” .

cd /usr/local/csf/bin/perl

If you see the test results as shown below, then CSF is running without problems on your server:

RESULT: csf should function on this server

CSF is running.

Step 3 - Configure CSF on CentOS 7

Before stepping into the CSF configuration process, the first thing you must know is that “CentOS 7” has a default firewall application called “firewalld”. You have to stop firewalld and remove it from the startup.

Stop the firewalld:

systemctl stop firewalld

Disable/Remove firewalld from the startup:

systemctl disable firewalld

Then go to the CSF Configuration directory “/etc/csf/” and edit the file “csf.conf” with the vim editor:

cd /etc/csf/vim csf.conf

Change line 11 "TESTING " to “0” for applying the firewall configuration.


By default CSF allows incoming and outgoing traffic for the SSH standard port 22, if you use a different SSH port then please add your port to the configuration in line 139 “TCP_IN” .

Now start CSF and LFD with systemctl command:

systemctl start csfsystemctl start lfd

And then enable the csf and lfd services to be started at boot time:

systemctl enable csfsystemctl enable lfd

Now you can see the list default rules of CSF with command:Advertisements

csf -l

Step 4 - Basic CSF Commands

  1. Start the firewall (enable the firewall rules):
csf -s
  1. Flush/Stop the firewall rules.
csf -f
  1. Reload the firewall rules.
csf -r
  1. Allow an IP and add it to csf.allow.
csf -a


Adding to csf.allow and iptables ACCEPT...ACCEPT  all opt -- in !lo out *  ->  ACCEPT  all opt -- in * out !lo  ->
  1. Remove and delete an IP from csf.allow.
csf -ar


Removing rule...ACCEPT  all opt -- in !lo out *  ->  ACCEPT  all opt -- in * out !lo  ->
  1. Deny an IP and add to csf.deny:
csf -d


Adding to csf.deny and iptables DROP...DROP  all opt -- in !lo out *  ->  LOGDROPOUT  all opt -- in * out !lo  ->
  1. Remove and delete an IP from csf.deny.
csf -dr


Removing rule...DROP  all opt -- in !lo out *  ->  LOGDROPOUT  all opt -- in * out !lo  ->
  1. Remove and Unblock all entries from csf.deny.
csf -df


DROP  all opt -- in !lo out *  ->  LOGDROPOUT  all opt -- in * out !lo  ->  DROP  all opt -- in !lo out *  ->  LOGDROPOUT  all opt -- in * out !lo  ->    csf: all entries removed from csf.deny
  1. Search for a pattern match on iptables e.g : IP, CIDR, Port Number
csf -g


Step 5 - Advanced Configuration

Here are some tweaks about CSF, so you can configure as you need.

Back to the csf configuration directory, and edit the csf.conf configuration file:

cd /etc/csf/vim csf.conf
  1. Don’t Block IP addresses that are in the csf.allow files.

By default lfd also will block an IP under csf.allow files, so if you want that an IP in csf.allow files never get blocked by lfd, then please go to the line 272 and change “IGNORE_ALLOW” to “1” . This is useful when you have a static IP at home or in office and want to ensure that your IP never gets blocked by the firewall on your internet server.

  1. Allow Incoming and Outgoing ICMP.

Go to the line 152 for incoming ping/ICMP:

ICMP_IN = "1"

And line 159 for outgoing ping ping/ICMP:

ICMP_OUT = "1"
  1. Block Certain Countrys

CSF provide an option to allow and deny access by country using the CIDR (Country Code). Go to line 836 and add the country codes that shall be allowed and denied:

  1. Send the Su and SSH Login log by Email.

You can set an email address that is used by LFD to send an email about " SSH Login" events and users that run the “su” command, go to the line 1069 and change the value to “1”.


And then define the email address you want to use in line 588 .

LF_ALERT_TO = "mymail@mydomain.tld"

If you want more tweaks, read the options in the “/etc/csf/csf.conf” configuration file.


CSF is an application-based firewall for iptables provided for Linux servers. CSF has many features and can support web-based management tools like cPanel / WHM, DirectAdmin and Webmin. CSF is easy to install and use on the server, it makes security management easier for sysadmins.

Curated by:

Est. 1999 | Paragon Host Internet Group | Web, Email, Workspace | Global Hosting Services