Arama Yap Mesaj Submit
Request a Callback
+90
X
X

Select Your Currency

Turkish Lira $ US Dollar Euro
X
X

Select Your Currency

Turkish Lira $ US Dollar Euro

Contact Us

Location Halkali merkez neighborhood fatih st ozgur apt no 46 , Kucukcekmece , Istanbul , 34303 , TR
Remove a cPHulk IP Block and Add a Whitelist Record | Eka Server
CPHULK BRUTE FORCE PROTECTION

cPHulk IP Lockout: Safely Restore WHM and SSH Access

cPHulk monitors failed logins to WHM, cPanel, SSH, FTP and mail services by account and source address. It does not always identify itself when blocking access, so symptoms can appear as invalid credentials, a timeout or a firewall-level drop. The correct remediation is to whitelist the administrator address and clear only the relevant lockout, not to leave protection disabled.

2087WHM logins are monitored
SSHPassword sessions are in scope
WHITELISTAdministrator address is always allowed
PUBLIC KEYcPHulk does not block key authentication
01
DIAGNOSIS

Separate the symptoms by technical layer

The same error screen can originate from different services. Separate network reachability, service state, firewall policy and authentication before changing anything.

A correct password is rejected

An IP-based or account-based threshold may have been reached without an explicit cPHulk message.

SSH times out

When firewall-level blocking is enabled, cPHulk may create an iptables rule.

Login works over mobile internet

The server and account are healthy; the previous public address is likely blocked.

Access returns when cPHulk is disabled

The lockout or firewall policy was generated by cPHulk and requires targeted cleanup.

02
ROOT CAUSE

Investigate the most likely causes in risk order

Instead of disabling the entire protection stack, prove which rule blocks access and change only the required scope.

High

Repeated password failures from one address

The source can receive a temporary or one-day block after crossing the configured threshold.

High

Account-based root lockout

Distributed attempts can lock the account regardless of the attacker source address.

Medium

Whitelist is missing or contains an old address

A dynamic public IP change makes the previous whitelist entry ineffective.

Medium

Firewall-level cPHulk block

A current iptables block can continue to drop traffic until the affected history is flushed.

03
SAFE REMEDIATION FLOW

Apply each step in order and keep it reversible

Back up the current configuration, validate syntax and keep a second administration session open before every service or firewall change.

01

Confirm the current public IP

Do not whitelist an address from an old VPN, mobile network or CGNAT session.

02

Review WHM history reports

Correlate the user, source address, service and timestamp for the failed login.

03

Whitelist the administrator narrowly

Use a single address or /32 instead of trusting a broad ISP network.

04

Flush only the affected IP history

Use flush_cphulk_login_history_for_ips instead of deleting all cPHulk evidence.

05

Check cPHulk and firewall layers together

A separate CSF or upstream firewall rule can remain active after the cPHulk record is removed.

06

Adopt SSH public-key authentication

Reduce password-based root access and preserve an independent recovery path.

04
COMMANDS

Run commands as root and replace sample values

Replace example IP addresses, ports and paths with your own values. Review command output before moving to the next step.

Check cPHulk and whitelist state
whmapi1 --output=jsonpretty cphulk_status
whmapi1 --output=jsonpretty read_cphulk_records list_name='white'
Add an IP to the whitelist
/usr/local/cpanel/scripts/cphulkdwhitelist 203.0.113.10
whmapi1 --output=jsonpretty create_cphulk_record list_name='white' ip='203.0.113.10' comment='Eka administrator IP'
Flush one IP lockout
whmapi1 --output=jsonpretty flush_cphulk_login_history_for_ips ip='203.0.113.10'
Inspect logs and service
tail -n 100 /usr/local/cpanel/logs/cphulkd.log
tail -n 100 /usr/local/cpanel/logs/cphulkd_errors.log
/usr/local/cpanel/scripts/restartsrv_cphulkd
Risk of administrative lockout

A wrong firewall, SSH or login-protection rule can make the server unreachable. Do not close management ports without KVM, VNC or provider console access.

05
FREQUENTLY ASKED QUESTIONS

Critical decision points

Does disabling cPHulk remove old lockouts?

Not always. Existing account or address locks can remain, so remove the affected history explicitly.

Does adding a whitelist record remove every firewall block?

The WHM API may remove cPHulk-generated blocks, but a separate CSF or provider firewall rule must be checked independently.

Is SSH public-key access affected by cPHulk?

cPanel documentation states that cPHulk does not affect public-key authentication, making it an important recovery path.

Should I flush all cPHulk history?

Usually not. Remove only the affected administrator address to preserve evidence and unrelated protection records.

07
RELATED GUIDES

Continue with the correct next step

EKA SERVER TECHNICAL KNOWLEDGE CENTER

Preserve access first, then harden security.

The correct security method is not to disable protection, but to measure the network, service and rule path and apply the narrowest safe change.

Technical support
Top