Page tree
Skip to end of metadata
Go to start of metadata


cPanel & WHM includes several Perl environments. The version of cPanel & WHM that you use determines the Perl environments on your server.  


While cPanel & WHM's installer requires basic Perl, cPanel & WHM does not require the /usr/bin/perl file in order to function. cPanel & WHM's codebase and the /usr/bin/perl file interact minimally.

Perl environments

Select the tab for your version of cPanel & WHM to view the available Perl environments on your server:

Unable to render {include} The included page could not be found.

Custom modules in cPanel & WHM

We regularly update cPanel & WHM's internal Perl. However, these updates may impact your custom Perl modules.

cPanel & WHM version 56 and later


Our upgrades to Perl may break custom code and modules that you used in previous versions of cPanel & WHM. 

cPanel & WHM version 56 and later ships with binaries that we compile against Perl version 5.22. This change directly affects any custom Perl code that you execute from cPanel binaries. It is critical that you test your plugins and hook code against Perl 5.22 to ensure that they continue to work correctly.

cPanel & WHM version 11.46 through 54

Error rendering macro 'excerpt-include' : No link could be created for '_CustomModules'.

Perl script modifications to use cPanel's Perl environments


If your distribution’s core Perl does not provide Perl modules, you may need to change the shebang (#) at the top of your scripts.

Change your shebang if any of the following statements are true:

  • Your scripts need to work on prior versions of cPanel & WHM.
  • Your maintenance scripts tie in to the cPanel & WHM codebase.
  • You want to use Perl 5.14 or later.

We recommend the following option to change the shebang (#!/usr/bin/perl) at the beginning of your script.

Modification to function on cPanel & WHM version 11.36 and later only

If the script must only function in cPanel & WHM version 11.36 and later, replace the shebang at the beginning of your script with the following shebang:



The /usr/local/cpanel/3rdparty/bin/perl symlink points to the location of Perl on the server. We do not recommend that you use the binary to which the symlink points, as it may move in future versions of cPanel & WHM.

Additional documentation