Custom Apache and PHP modules add features to the EasyApache system, and are accessible from both the command line and graphical WHM interfaces. These modules are compiled into Apache and/or PHP just like the modules provided with EasyApache.
Before you begin
You can find documentation for creating custom modules your server at WHM > EasyApache > Help > Cpanel::Easy Framework POD, or and via command line at
You can download a few sample custom modules below. These modules are not likely to be included
in EasyApache in the near future.
Important: If you have problems building Apache with your custom modules, and you are unable to troubleshoot the problem, run
/scripts/easyapache --skip-custom-optmods to build Apache and PHP without any custom modules. (Or, access the WHM equivalent found in EasyApache’s Help section).
To install a custom module:
- Download and unzip it into
- When logged into your server as
root, you can install any module listed below by running the following commands. Be sure to replace
$NAME.tar.gzwith the filename of the module you wish to download:
tar -C /var/cpanel/easy/apache/custom_opt_mods -xzf $NAME.tar.gz
In order to remove a custom module from the server, simply delete the files you created when you issued the above commands. The module will be removed from all future builds and the EasyApache interface.
Warning: cPanel does not provide support for custom modules, including the ones linked below. The following modules are not developed by cPanel, Inc. Use them at your own risk.
mod_auth_mysql — This module allows you to authenticate users and authorize access through a MySQL database.
mod_GeoIP — This module looks up the IP address of the client web user in the GeoIP database.
mod_python — This module embeds the Python interpreter into Apache, for faster Python applications.
GD with JIS-mapped Japanese font support — This module provides JIS-mapped Japanese font support for the GD library under PHP5.
Turkish locale patch for PHP5 — This module improves PHP5 support for Turkish.
suPHP PAM patch — This module allows you to use limits (
/etc/security*.conf) with suPHP.