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.
EasyApache Profile Stage - 11.38 - EasyApache - cPanel Documentation
Page tree
Skip to end of metadata
Go to start of metadata



This document applies to cPanel & WHM version 11.38 and older. For newer versions of cPanel & WHM, read our EasyApache Profile Stage  documentation.

The Profile stage of the  EasyApache (Apache Update)  interface provides a set of options and a list of the available profiles for your server. EasyApache uses the profile that you select as a template for your EasyApache build.

EasyApache profiles

An EasyApache profile contains a set of options that EasyApache will attempt to build. By default, EasyApache provides profiles that include the most commonly used options. Use the Profile stage of the EasyApache (Apache Update) interface to apply one of the profiles that we provide, customize a profile and save it as a new profile, or save a profile for use at a later date or on another server.

The following types of profiles are available in the Profile stage of the EasyApache (Apache Update) interface:

  • Optimal profiles that we recommend.
  • Your most recently saved configuration.
  • A profile that you previously saved or uploaded.
  • A basic profile that has minimal configuration.

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.

Build an existing profile

When you build an Apache profile, EasyApache installs it in the /var/cpanel/easy/apache/profile/_main.yaml file and uses it on your server.

To build an existing Apache profile, do the following:

  1. Navigate to the EasyApache interface in WHM (Home >> Software >> EasyApache (Apache Update)).
  2. Select the profile you wish to build from the list of available profiles under Begin by selecting a profile to load.
    • Click Show Info to view information and access four additional options about each profile.

      • Click here to view details — This option opens a small popup window that displays the version of Apache, versions of PHP, and features that are active in the profile. To view the Apache documentation for any of the listed features, you can click its More Info link.
      • Raw — This option opens a small pop-up window that displays the profile in plain text.
      • Download profile — This option downloads a copy of the EasyApache profile in plain text. You can use this option to install the same EasyApache profile across multiple servers.
      • About Profiles — This option opens a small popup window that contains general information about EasyApache profiles, what they do and where they reside.
  3. Click Build Profile Now.
  4. Click OK in the pop-up window to confirm that you wish to build and install the selected Apache profile.
  5. Read the warning in the next popup window and click I Understand.
    • The build process will take a few minutes; please be patient.
    • At any point during the build process, you may use the four links at the top of the page.
  6. WHM will display a new interface with information about the EasyApache profile that is being built.
    • Click Show More Build Details to enlarge the window detailing the build process.
    • Click Disable Auto Scroll to prevent the text box from automatically scrolling along with the build information.


      This option cannot be undone once it is checked.

  7. When the build is complete, you will be prompted to configure suEXEC and PHP. For more information about these options, read the PHP and SuExec Configuration documentation.
  8. Click Save New Configuration to display the new PHP and suEXEC configuration.
  9. Close the Configure Suexec and PHP window.
    • If you wish to edit the PHP and suEXEC configuration on your server later, navigate to WHM >> Apache Configuration >> PHP and SuExec Configuration

Once the build process is complete, click Download Log to download a detailed, plain text log.

Create a custom profile

You can create a custom profile that uses one of your existing Apache configurations as a template.

To create a custom profile:

  1. Select the Apache configuration you wish to edit.
  2. Click Start customizing based on profile to display the Apache Version interface.


To delete a profile, click Delete next to the profile you wish to delete. You may not delete the default profiles that come with cPanel & WHM.

Additional features

The Profile stage also provides the following links to additional features and information:

  • Help — Provides access to additional tools and options for EasyApache. For more information, read our EasyApache Profile Stage - 11.38 documentation.
  • Upload Profile — Allows you to upload a profile file.
  • About Profiles — Provides additional information about EasyApache profiles.
  • Build History — Provides information about previous EasyApache build attempts.
  • Build Log Manager — Provides access to the build logs from previous EasyApache build attempts.