cPanel/VHM integration

By Tugdual Saunier, on Jun 28, 2017


In the past months, we’ve had more and more users wondering how to install Blackfire with cPanel.

It was not an easy pick for us unfortunately. One of the greatest advantages of cPanel was one of our biggest challenges. cPanel enables their users to simply configure servers and extensions via a web UI. No need for them to dig into too advanced configurations, nor to worry about finding and installing the correct packages. Blackfire, on the other hand, is made to be extremely flexible in terms of configuration, and most of it is done via the command line, even if we provide simple copy/paste installation procedures. Without getting into too many details those different ways to build configurations were not compatible.

Thanks to a collaboration with the cPanel team, we are happy to provide a documentation that makes it possible for you to use Blackfire on cPanel/VHM.

Before starting, check with your provider that the Blackfire stack is installed and enabled on the server. If not, follow the administrator procedure or ask your provider to do so.

Then, follow the user procedure if you want to use different sets of credentials per website.

Please note that, at the time of writing, some more work is done by cPanel in order to smoothen the integration even more. Currently, some steps of the installation procedure need to be repeated on every cPanel upgrade.

Happy profiling,


Tugdual Saunier

Tugdual is a Product Developer at He started PHP programming when he was a teenager, and hasn’t stopped since. He discovered Symfony right after his studies and soon joined SensioLabs. A couple of years ago, with Fabien Potencier, he was exploring some options to optimize Symfony and Twig. And they got so frustrated by how hard it was to evaluate performance impact of some changes in code that they decided to explore the options available to improve the situation.