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

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.46

Overview

You can use our EasyApache system to configure the Apache web server before installation. To do this, you must also be able to access an existing cPanel & WHM server that runs EasyApache.

Create a new EasyApache profile

You can use an existing server to generate a new EasyApache profile, which you can then use to configure Apache on your new server. EasyApache allows you to adjust several configuration options. To set up a new profile, select your preferred options through either of the methods below.

Command line

To create your new profile from the command line, perform the following steps:

  1. SSH in to the existing server.

  2. Run the /scripts/easyapache script.

WHM

To create your new profile in WHM, use the EasyApache (Apache Update) interface (Home >> Software >> EasyApache (Apache Update)).

Important:

After you set up your new profile, run EasyApache .

 

Exhaustive Options List

When you reach the Exhaustive Options List stage of the EasyApache (Apache Update) interface, perform the following steps:
  1. Access the Exhaustive Options List. You can do this through the command line or in WHM.
    • This will allow the system to create your new profile. It will not need to compile and install it on the server.
  2. Assign a file name, a display name, and a brief profile description to the new EasyApache profile.
  3. Select Save Only (Do Not Build).
    • Your server will store the new profile in the /var/cpanel/easy/apache/profile/custom/ directory, but will not recompile Apache and PHP.
  4. Run the scp command to copy it to the /etc/cp_easyapache_profile.yaml file on the new server.

Preferences

The /var/cpanel/easy/apache/prefs.yaml file stores your preferences separately from the build profile. To use an existing installation to create your preferences on a fresh installation of cPanel & WHM, perform the following steps:

  1. On an existing installation, set your preferences in the EasyApache (Apache Update) interface (Home >> Software >> EasyApache (Apache Update)).
  2. On your new server, before you install cPanel & WHM, run the following command:

    mkdir -p /var/cpanel/easy/apache/ 
  3. Copy the /var/cpanel/easy/apache/prefs.yaml file from the existing system to the /var/cpanel/easy/apache/ directory on the new server.
  4. Put your build profile in the /etc/cp_easyapache_profile.yaml file on the new server.