EasyApache

Overview

EasyApache is a powerful and simple-to-use script that you can use to update and configure your Apache web server.

This documentation explains key points about the interaction between the Apache web server software and the cPanel & WHM system. It includes details about how you can use cPanel's EasyApache software to customize your build of Apache.

The current version of EasyApache is 3.18.17 which was released on June 10, 2013. For more information about the EasyApache versioning standard, read the EasyApache Versions documentation.

Note: You are not required to customize Apache and PHP with EasyApache. Instead, you may select one of our preconfigured profiles. If you choose one of our preconfigured profiles, Apache 2.2 and PHP 5.3 are installed by default, and PHP will be handled by suPHP.

How To Run EasyApache

To access EasyApache via the WHM interface, navigate to Home >> Software >> EasyApache

To access EasyApache via the command line, type the following command as the root user: /usr/local/cpanel/scripts/easyapache

EasyApache consists of the following stages:

• Profile — This stage of the EasyApache build process allows you to select the profile you will use as a template to build your EasyApache profile.
• Apache Version — This stage of the EasyApache build process allows you to select which version of Apache you want to use in your profile.
• PHP Version — This stage of the EasyApache build process allows you to select which version of PHP you wish to use.
• Short Options List — This stage of the EasyApache build process allows you to select features to include in your EasyApache profile.
• Exhaustive Options List — This stage of the EasyApache build process allows you to select more features to include with your EasyApache profile.

Before you change your EasyApache profile, we recommend that you update your server to the most current version of your cPanel & WHM build. WHM will perform a quick check of your version of cPanel & WHM, and will prompt you to update if you are not on the most current version.

• To update your cPanel within the EasyApache interface in WHM, click the Update link in the menu.
• To update your cPanel software at the command line, log in as root and type /scripts/upcp

Components in EasyApache

EasyApache currently provides three major components: the Apache web server, PHP, and Tomcat.

Apache

• Modules — A detailed list of the modules that you can build into Apache.
• Options — A detailed list of the options that you can build into Apache.
• More Information
  • Critical Changes In Apache 2.4 — Important changes in Apache 2.4.
  • The Apache Configuration File & Building Apache — An introduction to httpd.conf and cPanel's goals for the Apache build system.
  • How httpd.conf Is Processed — A brief description of how httpd.conf is processed by the AdvConfig build system.
  • ModUserdir Tweak — Tips on how to configure mod_userdir.

PHP

• Modules — A detailed list of the modules that you can build into PHP.
• Options — A detailed list of the options that you can build into PHP.
• Extensions — Information about how to install extensions you can add to PHP.
• More Information
  • Apache PHP Request Handling — You can customize how PHP handles requests.
  • Hardening PHP — You can secure information on your server by hardening your PHP settings.

Tomcat

• Introduction to Tomcat — Information about the Tomcat server.

Development

Developers can customize and enhance EasyApache with a variety of options and tools.

• Custom Modules — Custom Apache and PHP modules (also known as "opt mods") add features to the EasyApache system.
• Custom Templates — You can use custom templates to include information inside the httpd.conf file that the Template Toolkit will process. Custom templates are preferable to direct changes in httpd.conf, because your changes to httpd.conf could be overwritten.
  • Custom Directives Outside of a VirtualHost Tag
  • Changes Contained Within a VirtualHost Directive
• Environment Variables — Environment variables are containers for values that you can place within custom-created files to change the behavior of Apache and PHP.
• Flag Files — Flag files can change a program's behavior.
  • Raw Opts — You can use "raw opts" (also known as Custom Configure Flags) to help you configure the components that EasyApache is building.
• Script Hooks — Script hooks can perform actions at specific points in the EasyApache build process.
• Automated Post-Production Tests — You can create tests that EasyApache will run after each build.
• Profiles — More information about EasyApache profiles.
  • How to Save Custom Profiles — You can save EasyApache profiles for future use.
  • How to Distribute EasyApache Files Over Multiple Servers — You can move EasyApache profiles between servers. This is useful for distributing standard configurations across multiple servers.

PCI and Security

• How To Prevent CRIME Attacks — This document explains fixes made to EasyApache to prevent CRIME attacks.
• How To Mitigate Slowloris Attacks — This document demonstrates three methods you can use to mitigate Slowloris attacks.
• Symlink Race Condition Protection — This document features a new option to prevent the symlink race condition.

Other Issues

• Known Issues — Known issues with EasyApache.

News and Updates

• EasyApache 3.18 Release Notes
• EasyApache Change Log
• cPanel Forums: EasyApache

Support Level Definitions

When you configure EasyApache, you will see the following terms in the WHM interface that describe a product or feature's state of development:

• Experimental — This product is brand new and not fully-tested. It may have compatibility issues with other products.
• Deprecated — The product is considered out-of-date, but we will still support it. We may provide patches for compatibility and security issues, but you should consider upgrading to a newer version soon.
• End Of Life — This product has reached the end of its life. We provide the product in its current state and will not release security patches for it. We strongly encourage you to upgrade to a newer version.