Applicable to:
- Plesk Obsidian for Linux
- Plesk Onyx for Linux
Question
How to install WHMCS 7 on Plesk for Linux?
Answer
WARNING: Do not install WHMCS on the same Plesk server which will be managed by WHMCS, since web services will be restarting upon provisioning and it will cause errors in WHMCS.
Note: WHMCS is tested in Linux based environments running the Apache webserver. Other environments such as Windows-based configurations may experience compatibility issues and are not supported.
Note: WHMCS can be installed on servers with Plesk Obsidian, Plesk Onyx 17.8. WHMCS must be used for managing remote Plesk servers. Management of local server (the same Plesk server where WHMCS is installed) is not supported. WHMCS requires "WHMCS Plesk Provisioning Module" in order to manage remote Plesk servers.
Here are the steps to install WHMCS on a domain whmcs.example.com:
- Create a new database at Domains > whmcs.example.com > Databases.
- Download
whmcs.zipfile from vendor's site and unpack it to the httpdocs directory of example.com via Domains > whmcs.example.com > /httpdocs. - Rename the file
configuration.php.newtoconfiguration.phpand set write permissions to this file. - Set PHP version to 5.6 at Domains > whmcs.example.com > PHP Settings.
- Open the link https://whmcs.example.com/install/install.php and go through the installation steps.
- Remove the directory
/var/www/vhosts/whmcs.example.com/httpdocs/install/. - Access the admin panel at https://whmcs.example.com/admin.
WHMC has the module pre-installed, however, if it is missing, it can be installed using these steps:
-
Connect to the server via SSH;
-
Download module from https://github.com/plesk/whmcs-plugin as zip archive.
# cd /root && wget https://github.com/plesk/whmcs-plugin
-
On server create folder named "plesk" and copy all module files to it.
# mkdir /root/plesk/
-
Put this folder to
<WHMCS-root-directory>/modules/servers/on your server . For example, folder is/var/www/vhosts/whmcs.example.com/httpdocs/modules/servers/:# cp -a /root/plesk /var/www/vhosts/whmcs.example.com/httpdocs/modules/servers/
-
Log out from WHMCS and log into WHMCS as administrator.
The appropriate type of server ("Plesk") is now added to server types list and product setting "Module Name".
Comments
13 comments
Hello,
And support for PHP 7.1 or 7.0?
When I try installing with any of php 7 version, I'am getting blank pages (500 error).
Bonjour,
J'ai le même problème. Merci Plesk pour répondre.
@kanenses: Avez - vous résolu ce problème?
Je vous remercie de vos réponses,
Chaleureusement
Hello @Girardin, glad that you have found the answer to your question.
The following WHMCS documentation might also be useful for you:
https://docs.whmcs.com/PHP_7_Migration_Guide
Thanks for creating this article. I'd like to clarify a few points if I may.
1. The WHMCS software distro includes the Plesk provisioning module as standard, so steps 1-4 about downloading the module from GitHub are redundant.
2. It should be possible to install WHMCS on the Plesk server containing customer hosting accounts, provided Apache is configured to perform a graceful restart: https://support.plesk.com/hc/en-us/articles/213907285-How-to-enable-disable-Apache-graceful-restart-in-Plesk
Thanks!
@John Kipling
Thank you for your comment.
1. I have edited the article accordingly.
2. Apache's graceful restart workarounds the issue with the restarts, however, it is still not recommended to install WHMCS and Plesk on the same server: they can share the same resources and conflict with each other.
hi,
"Do not install WHMCS on the same Plesk server which will be managed by WHMCS, since web services will be restarting upon provisioning and it will cause errors in WHMCS"
1 - will this also apply to the upcoming Plesk Obsidian ?
2 - if not can this be added to suggested features or is it a technical limitation inherent with Plesk ?
(seems to me that cPanel, DirectAdmin etc can conveniently host WHMCS without the need for a separate server.)
kind regards,
RC.
Hi @Randall Camacho,
> 1 - will this also apply to the upcoming Plesk Obsidian ?
Most probably - yes, since it restarts Apache service in order to apply made changes
However, there is no info on the official WHCMS website whether they are going to support Obsidian or not
> 2 - if not can this be added to suggested features or is it a technical limitation inherent with Plesk ?
It is a limitation on the Apache side as it is restarted whenever any settings have to be applied
You can try to increase "Apache Restart Interval" in "Plesk at Tools & Settings > Apache Web Server". In this case, if you set Apache restart interval to 1800 (30 min), new settings will be applied after 30 minutes and you will not get "502 bad gateway" in WHMCS, e.g. during creation a new subscription
Another solution is using graceful Apache restart, however, keep in mind that graceful restart is unstable and can crash Apache or cause issues
Here is info how to turn it on:
How to enable/disable Apache graceful restart in Plesk?
> (seems to me that cPanel, DirectAdmin etc can conveniently host WHMCS without the need for a separate server.)
We have no information about how it works on other platforms so cannot provide you with any additional information here
thanks for your very kind and speedy reply in this.
one last question and i hope it is not a silly one ;
if Apache is the issue, how about servers running LiteSpeed ?
does the same issues exist on LiteSpeed servers ?
kind regards,
RC.
Hello @Randall Camacho,
Thank you for your question.
Currently standalone Litespeed webserver and standalone OpenLiteSpeed Web Server are not supported by Plesk.
More information on this matter you may also find here: Does Plesk Onyx support Litespeed Web Server?
Thank you for this update.
I have a question. Does WHMCS site on plesk panel supports connecting remotely to cpanel server for provisioning of hosting service on the cpanel server?
I currently have a whmcs hosted on a cpanel lxc container server.
Problems encountered:
cronjob is not working for the whmcs on the cpanel which needs some special configuration due to the LXC container environment.
I am not too sure cronjob will work on plesk panel for the whmcs website but would like to try it out.
Hello @Omotere Lanre Ebenezer,
Thank you for your question.
WHMCS can be used for managing remote Plesk servers, however, it was not tested if it can be used for provisioning of hosting service on the Cpanel server.
So we cannot guarantee that it will work as expected. It can be done at your own risk only.
How can we allow our Plesk Reseller to integrate WHMCS in their respective account without sharing root access or logins.
Just checking on this for V8.5. Is it still the case that you cannot/should not install WHMCS 8.5 on a Plesk server (same server) and have web hosting clients on that same server? I spoke with tech support at GoDaddy and said that you can absolutely install WHMCS on a cPanel server (same server with web hosting clients) and that that is what most hosting companies are doing.
Thanks!
Please sign in to leave a comment.