CSF 2.3 · Stable  ·  cPanel, CloudPanel & no panel

The firewall the modern Linux server deserves.

A firewall for cPanel & WHM, CloudPanel and servers with no control panel, built on native nftables, IPv4 + IPv6, an event-driven LFD 2.0, and live Threat Intelligence - part of UnderShield. Version 2.3.2 stable is available now, free and open source.

2.3.2 is the current stable release for cPanel, CloudPanel and servers with no control panel - tested on clean installs of 10 Linux distributions, with a reboot and a real SSH brute-force attack on each. GPL-3.0.

Part ofcPanel & WHMCloudPanelNo panelnftables · inetIPv4 + IPv6Stable · 2.3.2
CloudPanel & no panel · Stable

Not on cPanel? CSF now runs there too.

CSF 2.3 brings the same nftables engine, LFD 2.0 and Threat Intelligence to CloudPanel and to Linux servers with no control panel, with its own secure web interface instead of WHM.

01 / CLOUDPANEL

CloudPanel ready

The installer detects CloudPanel and opens exactly what it needs: SSH, HTTP, HTTPS (with HTTP/3) and the CloudPanel admin port 8443, which the lockout guard will never close. Optionally it publishes the web interface on your own HTTPS domain.

Stable
02 / NO PANEL

Plain Linux servers

On a server with no control panel, CSF opens only SSH, HTTP and HTTPS, and reads your SSH configuration (including sshd_config.d) so a custom SSH port is never locked out.

Stable
03 / WEB UI

Standalone web interface

The same firewall interface as in WHM, served by its own small service on 127.0.0.1 only. Sign-in with hashed passwords, two-factor authentication, CSRF protection and per-IP lockout, and failed logins are watched by LFD.

Stable
What's inside

Keep the CSF workflow. Rebuild the foundation.

Every capability below ships in the 2.3.2 stable release, backed by a 590+ assertion automated test suite and tested on 10 Linux distributions and live cPanel servers.

01 / ENGINE

nftables-first architecture

A single table inet csf with dynamic, timeout-capable sets - IPv4 and IPv6 in one model. Blocking one IP updates a set element, never a rebuild.

Stable
02 / DETECTION

LFD 2.0

An event-driven detection layer with modular collectors, incremental log tailing, temporary blocks with native set timeouts, and a clear reason behind every action.

Stable
03 / CPANEL

cPanel-native focus

Service and version detection, cPHulk and ModSecurity awareness, automatic SSH/cPanel port presets on install, and a WHM interface registered through AppConfig.

Stable
04 / INTELLIGENCE

Threat Intelligence feeds

Reputable IP/CIDR feeds (Spamhaus DROP, Feodo C2, CINS, IPsum, Blocklist.de) load into dedicated nftables sets with per-feed toggles and category policies - inbound, outbound, or both.

Stable
05 / SAFETY

Safe administration

Atomic rule changes, a lockout guard that checks your live SSH session, and a --safe-reload watchdog that auto-reverts if you can't confirm.

Stable
06 / UPDATES

One-click WHM updater

The WHM interface checks the release channel, then downloads, SHA-256 verifies, and installs new versions in place with a live progress bar - your config and lists preserved.

Stable
07 / MALWARE

Malicious upload scanning

Website files that changed are scanned every 5 minutes with ClamAV, the rfxn (Linux Malware Detect) signatures and YARA. Malware goes to quarantine and the uploader is blocked for 24 hours. Restore or delete with one click.

New in 2.3
How it works

From service signal to a dropped packet.

The path a request takes through CSF 2.1 - traceable steps, explainable decisions, no opaque automation.

01Attack

Suspicious activity reaches a protected service.

02Service event

A log line records an actionable signal.

03LFD 2.0

Collectors normalise it into a structured event.

04Correlation

The risk engine scores the source and checks thresholds.

05nftables set

The IP is added to a set with a timeout.

06Drop

Traffic is dropped in-kernel before it reaches the service.

LFD 2.0

Detection built for hosting reality.

Modular collectors watch the parts of a cPanel server that matter most and feed a single correlation engine, so a distributed attacker is recognised as one hostile actor and enforced progressively.

SSH, Exim, Dovecot, FTP, web-server and WAF signals are parsed by independent detectors into normalised events.
Temporary blocks with native nftables timeouts and a clear operator-facing reason for every action.
ModSecurity / OWASP CRS correlation escalates repeat, high-confidence WAF attacks to a network-layer block.
lfd 2.0 - event to enforcement
service      sshd
event        authentication_failure
source       185.203.44.19
score        72 / short block

action       add to csf_temp4 (timeout 300s)
reason       LFD: sshd auth_failure (score 72)
csf - familiar commands, modern engine
# csf -a 203.0.113.7      # allow
# csf -td 198.51.100.9 3600 # temporary deny
# csf -g 198.51.100.9      # inspect
# csf --safe-reload         # apply, auto-revert
# csf --self-update         # update in place

The familiar commands you know, on a native
nftables engine. Legacy csf.conf is migrated.
CLI compatibility

Same CSF philosophy. Modern Linux foundation.

Your operational muscle memory carries over. The familiar commands and configuration files drive a native nftables engine underneath.

Preserved: csf -a · -d · -td · -tr · -dr · -g · -r
Modern: csf inspect · health · migrate · --safe-reload · --self-update
Files in scope: csf.conf · csf.allow · csf.deny · csf.ignore
Interface

One clean interface, in WHM or on its own.

The same tabbed interface runs inside WHM on cPanel servers and as a standalone, two-factor protected web UI on CloudPanel and plain Linux. Screenshots from CSF 2.3.2 on Ubuntu 26.04 with no control panel; addresses shown are documentation examples.

CSF Dashboard screen
Dashboard Protection score, quick block / allow and recent LFD events.
CSF Malware Scan screen
Malware Scan Upload scanning with ClamAV and YARA, quarantine with restore and delete.
CSF Threat Intel screen
Threat Intel Reputation feeds in their own nftables sets, each with its own switch.
CSF Security Level screen
Security Level One-click presets, from Low to Attack mode.
CSF Diagnostics screen
Diagnostics Health checks and the detected platform at a glance.
CSF Secure sign-in screen
Secure sign-in Password plus two-factor code on servers without WHM.
Compatibility

cPanel, CloudPanel or no panel - with support claims kept honest.

CSF 2.3 runs on cPanel & WHM, CloudPanel and servers without a control panel, on native nftables. Every release is tested on clean installs, with a reboot and a real SSH brute-force attack on each system marked Tested.

Operating systems

AlmaLinux 8 / 9 / 10Tested
CloudLinux 9Tested
CloudLinux 8 / 10Supported
Rocky Linux 9Tested
RHEL / Rocky 8 / 10Supported
Ubuntu 22.04 / 24.04 / 26.04 LTSTested
Debian 12 / 13 (CloudPanel, no panel)Tested

Hosting integrations

cPanel & WHMSupported
CloudPanelSupported
Linux with no control panelSupported
Standalone web interface (login + 2FA)Supported
Malicious upload scanning (ClamAV + YARA)New in 2.3
nftables / inetImplemented
ModSecurity / OWASP CRSImplemented
Cloudflare edge allowlistOne-click
cPHulk, Apache, LiteSpeed, EximDetected
Availability

Download CSF 2.3.2 - stable.

2.3.2 is the current stable release, free and open source under the GNU GPL v3. It installs the native nftables engine, LFD 2.0, cPanel integration or its own web interface, Threat Intelligence, malicious upload scanning, the Cloudflare edge allowlist, WAF escalation, and the WHM interface - and cleanly migrates and uninstalls both legacy ConfigServer CSF v15 and the cPanel-maintained CSF fork. Available for cPanel, CloudPanel and plain Linux servers, and rolled out across UnderHost infrastructure as part of UnderShield.

Running 2.1 or 2.2? Update now: 2.3.2 fixes the firewall not starting after a reboot. Use the Update tab or csf --self-update - your configuration and lists are kept.

Protection and monitoring, built into UnderHost infrastructure.
ProductCSF 2.3
Build2.3.2
Channelstable
Released2026-11-06
Upgrades fromCSF 15 · cPanel CSF
LicenseGPL-3.0
PriceFree
Open source

CSF is on GitHub.

The full source code, every release with its SHA-256 checksum, the changelog and the issue tracker live in the public UnderHost/csf repository. Read the code before you install it, report a bug, suggest a feature or send a pull request - CSF is free software under the GNU GPL v3.

get the source
git clone https://github.com/UnderHost/csf.git
cd csf
sh run-tests.sh      # 600+ automated tests
sh install.sh        # as root
FAQ

Frequently asked questions

Everything administrators ask before switching their cPanel firewall.

Is CSF - Core Shield Firewall free and open source?
Yes. It is free and open source under the GNU GPL v3 - no license fee and no subscription.
Is this the same as ConfigServer Security & Firewall (CSF)?
It is an independent, next-generation fork of ConfigServer Security & Firewall, rebuilt on native nftables. It preserves the familiar csf commands and config files (csf.conf, csf.allow, csf.deny, csf.ignore) and adds an event-driven LFD 2.0, live Threat Intelligence, and an embedded WHM interface.
Can I upgrade from CSF v15 or the cPanel CSF fork?
Yes. The installer detects an existing ConfigServer CSF v15 install or the cPanel-maintained CSF fork, backs up and migrates your csf.conf, allow, deny and ignore files, then removes the old iptables-based install so no stale rules remain.
Which operating systems and control panels are supported?
cPanel & WHM on AlmaLinux, CloudLinux, RHEL and Rocky 8, 9 and 10 are supported; Ubuntu 22.04 / 24.04 LTS runs on the same nftables engine. CloudPanel and Linux servers with no control panel are supported from 2.3, tested on Debian 12 / 13, Ubuntu 22.04 / 24.04 / 26.04, AlmaLinux 8 / 9 / 10, Rocky 9 and CloudLinux 9. A modern kernel with nftables is required.
Can I use it without cPanel?
Yes, from 2.3. The installer detects CloudPanel or a plain Linux server and opens the right ports (SSH, HTTP/HTTPS, and 8443 for CloudPanel). Instead of WHM you get a standalone web interface that listens on 127.0.0.1 only, with its own login, two-factor authentication and lockout. On CloudPanel the installer can publish it on your own HTTPS domain. See no-panel installation.
Does it support nftables and IPv6?
Yes - a single native nftables inet table filters IPv4 and IPv6 together, with dynamic sets for CIDR ranges and timeout-based temporary bans.
Does it work with Cloudflare?
Yes. One click adds every Cloudflare edge IP range (IPv4 and IPv6) to the allow list, so visitor traffic proxied through Cloudflare is never blocked by LFD.
How do I install it?
Download the release, verify its SHA-256 checksum, and run install.sh as root. The installer migrates any legacy CSF, auto-detects your SSH and cPanel ports, and installs in TESTING mode until you enable enforcement. Full steps are in the documentation.