User Tools

Site Tools


Remote Server Install (Non-WHMCS server)

One Step Install

Run the following one step installer, it will install the files onto the remote server for you and install the cronjob.

cd /tmp; wget -N; tar -xvf installer.tar ; chmod +x installer.php; 

To start the installation

php installer.php arg1 arg2 arg3


Argument 1 Options Explanation
install-ioncube10 install the ioncube 10 version
Argument 2 Options Explanation
cpanel install the files into /var/www/html
cpanel-ea3 install the files into /usr/local/apache/htdocs
da install the files into /var/www/html
Argument 3 Options Explanation
default leave the default hash in the settings file alone
random Generate a random Hash to replace the default hash in the settings file
Any string Replace the default hash with the string provided. Avoid using quotes, it will be stripped out.

Example installer command

cd /tmp; wget -N; tar -xvf installer.tar ; chmod +x installer.php; php installer.php install-ioncube10 cpanel default

Note when running the one step installer, the installer will use your native php to run the installation commands. Therefore, if your native PHP have functions disabled (system() posix_getpwuid() fileowner() filegroup() fileperms(), then the installation will not work properly.

To check if the installation is completed properly, check the cronjob for root. At the bottom of the entry you should see a new entry that runs the php file CSFUnblockremote.php…. If there is no such cronjob, then temporary comment out the disable_function option in the the native PHP's php.ini file (/usr/local/lib/php.ini). Once installed, you can enable disable_function in the native php.ini file.

To complete the installation, comment out the disable_function in /var/www/php.ini. This php.ini is a of the native php.ini the installer made. You can comment the disable_function in this php.ini (/var/www/php.ini) and it won't affect your system's security as only the cronjob will use this php.ini file.

Manual Install

If you want to install it manually, you can upload the files in remoteUpload to the documentroot of your remote server that can be web accessible using the Web Address listed in the Admin Module.

If the web address is

Then MUST be accessible publicly

By default cpanel will be stored in


directadmin will be in


Once the file is uploaded, you would need to setup a cronjob to run CSFUnblockremote.php

Here is a sample cronjob


*/2 * * * * php -c /var/www/php.ini -q /var/www/html/CSFUnblockremote.php cron > /dev/null 2>&1


*/2 * * * * php -c /var/www/php.ini -q /var/www/html/CSFUnblockremote.php cron > /dev/null 2>&1

We are using a local php.ini file so that we don't have to make changes to the system wide php.ini file. If your system wide php.ini have the following functions disabled. It is advisable to make a copy of the system wide php.ini and make the cronjob to load the local customized php.ini

system() posix_getpwuid() fileowner() filegroup() fileperms()

Module Removal From Remote Server

If you installed the module using the one step installer then run the following commands to remove the module.

rm -rf /var/www/html/CSF*;
rm -rf /var/www/csf*;
rm -rf /var/www/*.cluster;
rm -rf /var/www/*.local;

Once the files are removed, you also need to remove the cronjob that runs /var/www/html/CSFUnblockremote.php

whmcs-csfunblockerv4remoteinstall.txt · Last modified: 2020/05/11 06:42 by wiki