Currently, we no longer develop EasyApache 3 and only release security updates. We have tentatively scheduled EasyApache 3 for deprecation at some point in 2018. You will receive at least three months notification prior to official deprecation. After that time, EasyApache 3 will no longer receive any updates. For more information, read our cPanel Long-Term Support documentation.
We strongly recommend that you upgrade to EasyApache 4. For more information, read our EasyApache 4 documentation.
What is EasyApache?
EasyApache is software that installs, modifies, and validates your Apache web server, PHP, Tomcat, and other components of your web server. WHM's EasyApache 3 interface (Home >> Software >> EasyApache 3) provides an interface that allows you to select which components you want EasyApache to install.
You do not have to use EasyApache, but it provides a convenient and easy method to modify your web server. Your cPanel & WHM license includes the EasyApache software.
For more information about EasyApache, read our EasyApache documentation.
Why should I run EasyApache, and how often should I run it?
EasyApache provides the following benefits:
- Automatic updates to PHP, Apache, and the modules that you select.
- Decreased security vulnerabilities due to the automatic updates.
- Access to configure Apache and PHP via the WHM or command line interfaces.
- A simplified method to add, remove, or install components of your web server.
- Recommendations about compatibility.
- Easy access to information about the options you select.
- Minimal downtime due to an automatic recovery process. If EasyApache detects an error in the server configuration and it is unable to automatically correct it, then EasyApache will revert your server to the previously working configuration.
We recommend that you run EasyApache whenever there is an update to software that you use. For example, if you use PHP on your server, run EasyApache each time that PHP releases an update.
How do I run EasyApache?
- Before you run EasyApache, we recommend that you update your server to the latest cPanel & WHM version. WHM will perform a check of your version of cPanel & WHM, and will prompt you to update if you are not on the latest version. This will allow EasyApache to configure and install the latest available features.
- To update your cPanel & WHM version, use WHM's Upgrade to Latest Version interface (Home >> cPanel >> Upgrade to Latest Version).
- To update your cPanel & WHM version via the command line, run the
/scripts/upcpscript as the
- When you run EasyApache, it will automatically update to the latest available version of EasyApache.
To run EasyApache via the WHM interface, use WHM's EasyApache 3 interface (Home >> Software >> EasyApache 3).
To run EasyApache via the command line, run the
/scripts/easyapache script as the
What do EXPERIMENTAL, DEPRECATED, END OF LIFE (EOL), and NOT SUPPORTED mean?
When you configure EasyApache, the following terms in the WHM interface describe a product or feature's state of development:
- EXPERIMENTAL — This product is 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 may wish to upgrade to a newer version soon.
- END OF LIFE — This product has reached End of Life (EOL). 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.
- NOT SUPPORTED — EasyApache does not support this product. This product will not receive further updates.
How can I run EasyApache and keep my custom configuration?
If you manually modified your Apache, PHP or Tomcat configurations, we recommend that you perform the following actions before you run EasyApache:
- Read the EasyApache - Development documentation.
- Access the EasyApache 3 interface and verify that EasyApache has the versions of the software that you use. EasyApache will not make changes to your server until you direct it to initiate the build process.
- Save a backup copy of all of your configuration files.
- Run EasyApache with the options that you wish to use.
Use the procedures in our EasyApache - Development documentation to modify the configuration files to restore the necessary parts of your custom configuration.
EasyApache will automatically remove changes to the configuration if they are not in the correct files. Read our EasyApache - Development documentation for more information.
Which EasyApache options should I select?
The EasyApache options that you select will determine what EasyApache builds into your web server. As a general rule, do not select an option unless you need it. For each option that you select, make certain that you understand the functionality of the option and any security vulnerabilities that may come with it.
We strongly recommend that you do not use options marked DEPRECATED or NOT SUPPORTED. They may introduce security vulnerabilities or instability to your server.
What should I do if I need an Apache module, PHP module, or PHP version that is not available in EasyApache?
EasyApache provides a mechanism that allows you to add options to EasyApache via custom modules. For example, you can add PHP or Apache modules, or PHP versions.
For more information on custom modules, read our Custom Modules documentation.
What is the Apache
This option allows Apache to serve files which are located inside of the virtual host's document root. For example:
What is the Apache
If you enable symlinks via
FollowSymlinks, Apache will only serve content via a symlink when the owner of the symlink matches the owner of the file (For example, the user
bob links to a file that
bob owns). However, Apache's documentation for symlinks states that a potential race condition with symlinks exists and the directive will affect server performance.
What is the race condition?
Apache performs a test for symlinks as it turns a URL into a file path on disk. Apache handlers expect to operate on the file path rather than on an open file handle. So, a race condition exists titled time of check time of use (TOCTOU) between the step where Apache validates the path and when a content handler accesses the symlinked file.
What does the Rack911 patch do?
The Rack911 patch turns the Apache
FollowSymlinks directive into the Apache '
FollowSymlinks' + '
SymLinksIfOwnerMatch' directive. This provides a quick way to activate both of these directives in the
httpd.conf file at the same time.
How does the Rack911 patch protect my website from the race condition?
The Rack911 patch itself does not protect against the race condition. Instead, this patch changes the Apache
Options FollowSymlinks directive into a shortcut for the Apache
Options FollowSymlinks SymLinksIfOwnerMatch directive. If you use this patch, your users cannot turn off both the Apache
SymLinksIfOwnerMatch directive and symlinks. Because Apache does not provide a detailed ACL approach for these options, this solution provides a quick way to enable and disable symlinks at a system-wide level within the
What does the new Bluehost.com patch do?
The Bluehost.com patch modifies Apache and APR so that Apache cannot access certain files. However, the Bluehost.com patch only affects requests that Apache's default handler processes (for example, static files such as
.html files). The Bluehost patch does not affect requests that application content handlers such as
Traditionally, systems administrators assign content handlers to the content that they want to serve. For example, the
mod_php handler serves PHP scripts, and the
mod_cgi hander serves arbitrary CGI scripts. When Apache cannot find a content handler associated with an incoming request, Apache resorts to the
default_handler reads in the contents of a file and displays it as-is to the requestor (for example,
cat file.txt > requestor).
A problem occurs when an application runs as the
nobody user. The application will create files on the server that the user
nobody owns, which does not match the owner. Because the patch prevents access to static content that does not match the owner, the user cannot view these files.
Why would I want to use the Bluehost.com patch if the files it creates are inaccessible?
If your applications run as a specific user, then the files the application writes will possess the correct ownership.
If the Bluehost.com patch prevents access to files that the user does not own, how does it determine what the user owns?
The Bluehost.com patch compares the UID of the requested file to the owner of the document root. If the owners do not match, Apache returns the following error code:
Finally, the system writes a warning to the
/usr/local/apache/error_log file that will resemble the following example:
Common issues and errors
When EasyApache builds, it creates a log file that contains all of the EasyApache process's output. EasyApache stores the build log files in the
If EasyApache fails to build successfully, EasyApache provides a general statement of the error near the end of the log file, and then a more specific failure error. If you see any of the following text in the EasyApache log file, look further down in the log file to determine the cause:
Could not ensure pkglist
Syntax error on line
Failed to generate a syntactically correct Apache configuration
Configuration problem detected on line ... of file ...
When I try to run EasyApache, I get the error "EasyApache is currently running"
This error message indicates that your system detects another instance of EasyApache and will not proceed until that instance completes. You cannot run multiple instances of EasyApache at the same time. Some common causes of this error include the following situations:
- EasyApache is open in another browser tab. The issue will resolve after the other instance of EasyApache completes.
- Something initiated the EasyApache script (
/scripts/easyapache) to run via the command line. The issue will resolve after the other instance of EasyApache completes.
- The EasyApache process hung and cannot complete. The system administrator will need to investigate the cause of the issue. We recommend that you determine the cause of the issue before you kill the EasyApache process.
When I try to run EasyApache, it repeatedly says that it is trying to update
The first thing that EasyApache does is check to see if there are any updates available. The most common causes of this issue relate to network connectivity. The EasyApache software requires access to our update servers, and will retry repeatedly if it cannot reach them.
In rarer cases, you may experience this issue when we are in the process of an EasyApache release. If you are certain that there is no connectivity issue, then we recommend that you wait up to one hour and then run EasyApache to receive the update.
EasyApache completed successfully, but now some sites that use PHP load a blank page or a PHP error
The most common cause of this issue is that the new EasyApache configuration uses a different PHP version than the previous EasyApache configuration used.
The EasyApache build may have changed your PHP version from one minor version to another. For example, code written for PHP version 5.3 may not be compatible with PHP version 5.4. EasyApache will not automatically change the version unless you select a default profile, or if your last EasyApache build contained a version of PHP that we no longer support.
Updates to minor revisions of PHP do not usually affect compatibility. For example, code written for PHP version 5.4.28 should still function correctly with PHP version 5.4.29.
To resolve the issue, select the correct PHP version and rebuild EasyApache. If the version of PHP is not available, the developer of the incompatible code will need to either modify the code or you will need to use a custom module for the necessary PHP version.
We strongly recommend that you do not use a version of PHP that has reached End of Life (EOL) or that we mark as DEPRECATED or NOT SUPPORTED. They may introduce security vulnerabilities or instability to your server.
This issue may also happen if you do not select a PHP handler after you run EasyApache. Use WHM's Configure PHP and suEXEC interface (Home >> Service Configuration >> Configure PHP and suEXEC) to select a PHP handler.
EasyApache completed successfully, but now some or all sites load an Apache error
If you include options that have different file permissions or security settings than your previous build, you may need to make additional adjustments. For example, the modules suPHP and ModRuid2 require specific file permissions to work correctly.
Before you can resolve the issue, you will need to determine what the root cause of the issue is. If the Apache error that the web browser displays is not clear, review the following sources of information:
- The Apache error log — You can access the Apache error log for your sites in the Raw Apache Log Download interface (Home >> Account Functions >> Raw Apache Log Download), which may help you determine the cause of the specific error.
- The EasyApache build log — The EasyApache build log will help you determine if there was an error in the build that was not a complete failure so the EasyApache build process completed. To access your EasyApache build log, click the Build Log Manager link in the EasyApache 3 interface (Home >> Software >> EasyApache 3).
- The EasyApache build history — The EasyApache build history may help you determine what changed in your most recent EasyApache build. To access your EasyApache build history, click the Build History link in the EasyApache 3 interface.
.htaccessfiles — For information about
.htaccessfiles, view Apache's Apache HTTP Server Tutorial: .htaccess files documentation for Apache version 2.4, or Apache's Apache HTTPD Server Tutorial: .htaccess files documentation for Apache version 2.2.
EasyApache fails with an error that includes "cannot open shared object file: No such file or directory"
The full error that you receive will look similar to the following text, but the file names in the error may be different:
This error message means that EasyApache was unable to locate, access, or load the file that is in the error. This following issues can cause this error:
- A typo in the directory or file name.
- If the module is a custom module, you may have extracted it to a different directory.
- Incorrect permissions on the file.
- The module depends on libraries that Apache is unable to load.
To resolve the error message, correct all locations where the issue occurs in the Apache configuration.
EasyApache fails with an error about ModSecurity
The ModSecurity software firewall can cause a variety of different errors if the configuration is not correct.
For example, the following error indicates that a rule in the configuration uses a DEPRECATED ModSecurity feature.
The following error indicates that the configuration has two or more rules with the same ID:
EasyApache fails with the error "Error: Protected multilib versions"
This error indicates the following situation:
- EasyApache requires a specific version of a package that is on your server.
- Your server currently has a different version of that package.
- EasyApache is unable to update the package because it is part of a multiple library (
multilib) package that it cannot modify.
To correct this issue, the system administrator needs to update the
multilib package to the version that EasyApache requires. In some cases, the command
yum update will resolve the issue.
EasyApache fails with a configuration problem and specifies a syntax error such as "Either all Options must start with + or -, or no Option may"
The actual error message that you receive may vary. The following is an example error message that is related to the
SymLinksIfOwnerMatch Apache option:
To resolve this issue, correct the options that are in your Apache configuration files. For more information on the syntax and options that are available for your Apache configuration, view Apache's Directive Quick Reference documentation for Apache version 2.2, or Apache's Directive Quick Reference documentation for Apache version 2.4.
EasyApache fails with the error "Skipping rest of tests: httpd not running"
This error indicates that after EasyApache completes the build process, the Apache process (
httpd) did not start correctly. This may happen if you install additional web server software, such as Litespeed. If Litespeed is the cause of the issue, the full error message will include the following output:
To resolve this issue, perform the following steps:
- Kill the Litespeed processes.
- Run EasyApache.
- After the EasyApache build completes, kill the Apache processes.
- Start Litespeed.
EasyApache fails with the error "[Errno 14] PYCURL ERROR 22 - "The requested URL returned error: 404 Not Found" Trying other mirror"
This error indicates that the yum repository list on your server contains a URL that does not resolve to a server correctly. If the other entries in your yum repository list work correctly, this should not cause EasyApache to fail.
To resolve the issue, correct the issues in your yum repository list. For more information on your yum repository list, read your operating system documentation.
EasyApache fails with the error "Cannot allocate memory"
This error indicates that your server does not have enough memory to run EasyApache. The more options that you select in EasyApache, the more memory EasyApache requires to build successfully. You must increase the available memory on the server to at least 512 MB of RAM before you run EasyApache.
EasyApache fails with the error "Error unpacking rpm package"
This error indicates that your server was unable to unpack an RPM that EasyApache requires. The full error message may look similar to the following example:
This may be due to an issue with the package that is in the error. In some cases, the
yum update command will resolve the issue.
EasyApache fails with a disk space error such as "No space left on device"
A disk space error indicates that your server does not have the disk space to unpack all of the packages that EasyApache requires. The specific error message you receive may vary. The following is an example of a disk space error message:
To resolve the issue, the system administrator must increase the amount of available disk space or inodes on the server.
EasyApache fails with the error "The server's system package manager, 'YUM', failed."
This error indicates that the yum update system experienced an error. Many problems could cause this issue.
For example, yum may fail for any of the following reasons:
- Multilib version problems.
- A corrupt RPM database.
- Broken RPM dependencies.
- A large number of duplicate RPMs.
- Bad mirrors.
- Failed installations.
- RPMs could not add or remove files in system paths, due to a variety of conditions.
To troubleshoot this error, run the following command:
During the update process, yum checks all of your packages for issues. The error or errors that this command produces will identify the source of the problem.
The most common reason for this error is multilib problems with the