Child pages
  • Custom Modules
Skip to end of metadata
Go to start of metadata

Overview

Custom Apache and PHP module, also known as "Opt Mods" and "optmods", add features to the EasyApache system. You can access these modules from both the command line and the WHM interface. EasyApache will compile these custom modules, as well as all of the other modules that you select into PHP and Apache.

Important:

EasyApache 4 (EA4) does not use optmods.

 Before you begin

You can find documentation about custom modules for your server in the following locations:

  • WHM — Navigate to Home >> Software >> EasyApache 3 >> Help >> Cpanel::Easy Framework POD
  • Command Line — /scripts/easyapache --perldoc

    Note:

    If you have problems when you build Apache with custom modules, run the /scripts/easyapache --skip-custom-optmods command. (You can also execute this command from the EasyApache Help section in WHM.) This command causes EasyApache to build Apache and PHP without any custom modules. If Apache and PHP build cleanly without the custom modules, then you need to correct or omit the custom modules.

Warning:

EasyApache 3 is scheduled for deprecation in January of 2018, when cPanel & WHM version 62 reaches End of Life. After that time, EasyApache 3 will no longer receive any updates. For more information, read our cPanel Long-Term Support documentation.

cPanel & WHM will not support EasyApache 3 in version 64 or later. We strongly recommend that you upgrade to EasyApache 4. For more information, read our EasyApache 4 documentation. 

Install a custom module

To install a custom module, perform the following steps on the command line as the root user: 

  1. Download the custom module archive file to your computer.
  2. With your preferred file transfer method, upload the custom module's archive file to your server's /var/cpanel/easy/apache/custom_opt_mods/ directory.

  3. Decompress and unarchive the file with the following command, where $NAME.tar.gz represents the name of the optmod's archive file:

    tar -C /var/cpanel/easy/apache/custom_opt_mods -xvf $NAME.tar.gz

    Important:

    To enable a custom module, you must select the module in the Exhaustive Options List section of the EasyApache 3 interface (Home >> Software >> EasyApache 3).

Remove a custom module

To remove a custom module from the server, delete the files that are associated with that custom module. This will remove the custom module from all future builds and the EasyApache interface.

Available modules

Warning:

cPanel does not provide support for custom modules.

ModuleDescriptionCustom module filenameLinks
mod_frontpage

This custom module enables FrontPage™ extensions.

Warnings:

  • We strongly recommend that you do not install FrontPage. Microsoft® discontinued support for FrontPage extensions on Linux servers in 2006. Exercise caution if you install FrontPage extensions, as they have been known to cause security issues. We recommend that you publish content with a different method, such as FTP or WebDAV
  • FrontPage is only compatible with Apache version 2.2.
  • FrontPage is not compatible with mod_ruid2. If you enable mod_ruid2, you must remove mod_frontpage.
  • mod_frontpage is not compatible with the MPM ITK. If you enable the MPM ITK, you must remove mod_frontpage.
custom_opt_mod-frontpage-20140912.tar.gzDownload
mod_geoIPThis module looks up the IP address of the client web user in the GeoIP database.custom_opt_mod-mod_geoip.tar.gz

Download

Information

mod_wsgiThis module embeds the Python interpreter into Apache for faster Python applications. Information
GD with JIS-mapped Japanese font supportThis module provides JIS-mapped Japanese font support for the GD library under PHP5.custom_opt_mod-php5-gd_jis_mapped_japanese_font_support.tar.gzDownload
Turkish locale patch for PHP5This module improves PHP5 support for the Turkish locale.custom_opt_mod-php5-turkish_locale_patch.tar.gzDownload
PHP5.2

This custom module allows you to use PHP version 5.2. You may use this module with mod_ruid2 and Apache version 2.2.

Warnings:

  • We strongly recommend that you do not install PHP 5.2. Installation of this module is at your own risk with no support provided. PHP 5.2 reached end of life on January 6, 2011. You should use this module only to upgrade to a more recent version of PHP. 
  • This module is not compatible with FCGI.
  • Select only one of the PHP 5.2 modules. If you extract both modules, the last one that you extract will overwrite the other.
  • If you use this module, EasyApache will ignore the PHP options that you select from the Exhaustive Options List stage of the EasyApache interface.
custom_opt_mod-PHP5217update.tar.gz Download
PHP5.2 with FCGI

This custom module includes PHP version 5.2 and FCGI. You may use this module with Apache version 2.2.

Warnings:

  • We strongly recommend that you do not install PHP 5.2. Installation of this module is at your own risk with no support provided. PHP 5.2 reached end of life on January 6, 2011. You should use this module only to upgrade to a more recent version of PHP. 
  • This module is not compatible with mod_ruid2
  • Select only one of the PHP 5.2 modules. If you extract both modules, the last one that you extract will overwrite the other.
  • If you use this module, EasyApache will ignore the PHP options that you select from the Exhaustive Options List stage of the EasyApache interface .
custom_opt_mod-PHP5217update-fastcgi.tar.gz Download
suPHP PAM patchThis module allows you to use limits (/etc/security*.conf) with suPHP.custom_opt_mod-suphp_pam_patch.tar.gz

Download

Information

mod_reqtimeoutThis module allows you to mitigate Slowloris attacks.custom_opt_mod-reqtimeout.tgz

Download

Information

mod_remoteipThis module replaces the original client IP address with the useragent IP address that is configured with the RemoteIPHeader directive.custom_opt_mod-remoteip.tgz

Download

Information

mod_pagespeed

This module allows you to install the mod_pagespeed module via EasyApache.

Module maintained at https://github.com/pagespeed/cpanel

Download

Information

PhalconThis module allows you to install the Phalcon PHP framework. For more information on the Phalcon PHP framework, visit the phalcon website.Module maintained at https://github.com/thecpaneladmin/EA-PhalconPHP

Download

Information