The following is a technical how-to to install the Xenica Module for WHMCS. This step by step guide will walk you through modifying your WHMCS install.

NOTE : You should have administrative(root) access to your WHMCS server. As you will need to add new packages to your WHMCS server.

1. Find your php.ini file location (You can use this command : 'php -i | grep php.ini') and Open with any Text editor , Search with keyword disable_functions , and Make sure you don’t have the below functions disabled : proc_open curl_exec

2. Install RRDTooL

if you have Cpanel then RRDTOOL is installed by default into the /usr/local/cpanel/3rdparty/bin/ folder. remember this path that you will need to Add it to Xenica configs later.

for installing RRDTool in clean machine use one of the following commands (depends on your distro):

   yum install rrdtool –y
   apt-get install rrdtool
   rpm -ivh

once sucessfully installed, you’ll find rrdtool in /usr/bin/

3. Install python mysqldb

use one of the following commands (depends on your distro):

   yum -y install python-pip
   pip install mysqlclient
   yum install MySQL-python
   apt-get install python-pip python-dev libmysqlclient-dev
   pip install mysqlclient

4. you can download Xenica files from servarica WHMCS download section () and upload your files manually to your whmcs machine , or you can follow these auto installation script instructions :


  • Once Downloaded , change permission and run
chmod +x

  • Once you run, it will ask for WHMCS installation path, enter the path Then press “y” for conformation.
[root@localhost ~]# ./
Enter current WHMCS Path:/var/www/html/whmcs/
You have entered WHMCS Installation current directory: /var/www/html/whmcs/
Are you sure?[Y/N]y
Xenica Source Found..Extracting it. Wait....

5. Set User/permissions for the newly copied files :

make sure that files in


has the same user/permissions like any other whmcs file,

the owner must not be root , because apache needs to handle those files,

lets assume that your normal whmcs files owner is 'apache' and your WHMCS path is /var/www/html/whmcs/:

cd /var/www/html/whmcs
chown -R apache:apache modules/servers/Xenica
chown -R apache:apache modules/addons/xenica

rrds,kickstarts and graphs folders need to be writable by apache ,

chmod -R 755 modules/servers/Xenica/rrds 
chmod -R 755 modules/servers/Xenica/kickstarts 
chmod -R 755 modules/servers/Xenica/graphs 

6. go to WHMCS and Activate xenica addon module :

Navigate to WHMCS , Setup ⇒ Addon Modules |⇒ Xenica ⇒ Click on “Activate”

Once You click activate, Click the configure button and Assigning roles like “Full Administrator” For this add-ons.

Fig 3 : Add-On Activation

7. Visit Xenica addon (WHMCS > Addons =⇒ xenica )

then complete the installation wizard from there.

Fig 4 : WebInstall

8. Once you redirected to the web-installation wizard, you need to enter your License Key (By clearing the current example value). You can take your code from your client area in

Fig 5 : License

  • xenica_install_instructions_updated.txt
  • Last modified: 2018/05/25 11:42
  • by sathish