cPanel & WHM no longer develops or updates EasyApache 3. We deprecated EasyApache 3 on December 31, 2018. We removed support for EasyApache 3 in cPanel & WHM version 78.
Raw Opts - EasyApache - cPanel Documentation

You can find our user documentation at

Check out our new API beta site!

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



Modified raw opts can result in a non-functional Apache build. cPanel, Inc. assumes no responsibility for custom changes, nor do we provide any warranty for what you do with this information. Proceed with caution.

Raw opts (or custom configure flags) are lines of data that advanced users can add to a specific file on the server to customize the configuration of the make command, Apache, PHP, or ModSecurity™. EasyApache allows you to specify any configuration options that the make command, Apache, PHP, or ModSecurity supports.

Raw Opts

The following list contains the correct filenames for ModSecurity™, the make command, and for each version of Apache and PHP for which you can configure flags:


You must manually create the following files in the /var/cpanel/easy/apache/rawopts directory before you add a custom flag.
  • For Apache 2.2 — /var/cpanel/easy/apache/rawopts/Apache2_2
  • For Apache 2.4 — /var/cpanel/easy/apache/rawopts/Apache2_4
  • For all PHP 4 versions — /var/cpanel/easy/apache/rawopts/all_php4
  • For all PHP 5 versions — /var/cpanel/easy/apache/rawopts/all_php5
  • For Mod_suPHP — /var/cpanel/easy/apache/rawopts/all_suphp
  • For a specific PHP Version — /var/cpanel/easy/apache/rawopts/PHP-X.X.X
  • For ModSecurity — /var/cpanel/easy/apache/rawopts/ModSecurity
  • For the  make command —  /var/cpanel/easy/apache/rawopts/make

Featured documentation

  EasyApache 3


Change Log Release Notes  



Migrate from Tomcat 5.5 to 7

How to Deploy Java Applications


EasyApache 3 does not support new installations of Tomcat.

As of cPanel & WHM version 76, EasyApache 4 now supports Tomcat 8.5. For more information, read our Tomcat documentation.

Add a custom flag


To add a custom flag, perform the following steps:

  1. Create the file that corresponds to the version of Apache or PHP that will receive the custom flag.
  2. In the file, enter the flag that you wish to add.
    • EasyApache parses the flag and formats the options properly before it adds them to the data structure.
  3. Save your changes.

Example of Custom Flag with data


Enter only one item per line.


This data results in the following command-line structure:

--with-module --path-to-module=/usr/bin/module --my-option

Raw opts with Apache 2.4

If you use raw opts to add statically-compiled functionality into the Apache binary, then you must change the --with-module flag to the --with-module=static flag. The module will not compile if =static is not included. 

Raw opts with ModSecurity

If you use raw opts to call the fuzzyHash operator in ModSecurity, you must install ssdeep. You must also add the --with-ssdeep=<path/to/ssdeep> flag to your raw opts file. If you do not include this, the operator will not function. 

Raw opts with the make command

EasyApache passes the -j2 option by default if your system uses more than one core. Set options in this file to compile EasyApache with a different number of cores. 


If this file does not exist or is empty, EasyApache uses its default behavior.

How to skip your raw opts

If you experience problems with your Apache builds, you can skip your raw opts before build time. This can be useful for troubleshooting purposes.

To skip your raw opts with the command line interface, perform the following steps:

  1. Run the following script before you issue the build command:

    /scripts/easyapache --skip-rawopts

    Rebuild Apache with the /scripts/easyapache script.

To skip your raw opts with the WHM interface, perform the following steps:

  1. Click the Help link.
  2. Select the Do not use raw opts support checkbox.
  3. Click Submit.
  4. Return to the previous screen and build the profile.

If the build completes successfully, you must reconfigure or omit your raw opts.