How to Save a Custom EasyApache 4 Profile

In This Tutorial:

Convert Save Upload

Using EasyApache 4 (EA4), you can easily manipulate the configuration for PHP and Apache by installing various modules and extensions that may be required for your website. EA4 comes with a few default configurations called Profiles. These profiles are custom configuration templates that include specific PHP and Apache modules intended for integrating certain applications within the server. Profiles are used to quickly configure Apache and PHP without having to select each component for installation. They can also be used to provide a restore point of a known working configuration, in the event of a disasterous server failure. In this guide, you will learn how to save a profile in EasyApache 4.

Convert to Profile

If you have already provisioned a profile with your preferred Apache and PHP modules installed, then you can simply convert the currently installed package into a profile, using the WHM/EA4 interface. The following instructions will guide you through this process.

  1. WHM login screen, Username root, Password field filled, and Log in button highlighted

    Log into WHM as root.

  2. Search term easy entered into WHM search field

    Type ‘easy‘ into the search field in the top left of WHM.

  3. WHM Software EasyApache 4 menu option highlighted

    Under the Software category, click on EasyApache 4.

  4. Currently Installed Packages section Convert to profile button highlighted

    In the Currently Installed Packages section, click on the Convert to profile button.

  5. Convert to profile detail fields highlighted and filled in with example from table below

    Enter the details of the profile into the fields as described in the table below. Example values are provided, however, you will want to enter your own custom values as they relate to your configuration.

    Field Description Example Value
    Name Required: Type the name of the Profile. This will be the name displayed in the WHM Available Profiles list. suPHP Event (All PHP)
    Filename Required: Type the name of the file. This will be the filename saved in the directory: /etc/cpanel/ea4/profiles/custom/. suphp-event-all-php
    Description Optional: Type a brief description of the profile. This will be displayed in the WHM Available Profiles list and can help to easily identify the packages installed in the profile. suPHP Apache MPM Event All PHP Versions included
    Tags Optional: Type a few tags separated by commas. This can help to easily find the package based on the tags you enter here. suphp, mpm event, all php
  6. Convert to profile pop-up Convert button highlighted

    Once you have typed all the details into each field, click the Convert button.

Save a Profile

At any point during the process of selecting Apache and PHP modules to be provisioned, you can save the configuration as a profile. The following steps will guide you through the process of saving a profile prior to provisioning it.

  1. WHM login screen, Username root, Password field filled, and Log in button highlighted

    Log into WHM as root.

  2. Search term easy entered into WHM search field

    Type ‘easy‘ into the search field in the top left of WHM.

  3. WHM Software EasyApache 4 menu option highlighted

    Under the Software category, click on EasyApache 4.

  4. Currently Installed Packages Customize button highlighted

    Under the Currently Installed Packages section, click on the Customize button.

  5. Make your selections for the Apache MPM and Modules, PHP Versions and Extensions, and Ruby via Passenger Modules.

    Customize Profile Review menu option highlighted

    Once you have made your selections click on Review.

  6. Review Profile section Save as profile button highlighted

    In the upper right, click on the Save as profile button.

  7. Save as profile detail fields highlighted and filled in with example from table below

    Enter the details of the profile into the fields as described in the table below. Example values are provided, however, you will want to enter your own custom values as they relate to your configuration.

    Field Description Example Value
    Name Required: Type the name of the Profile. This will be the name displayed in the WHM Available Profiles list. suPHP Event (All PHP)
    Filename Required: Type the name of the file. This will be the filename saved in the directory: /etc/cpanel/ea4/profiles/custom/. suphp-event-all-php
    Description Optional: Type a brief description of the profile. This will be displayed in the WHM Available Profiles list and can help to easily identify the packages installed in the profile. suPHP Apache MPM Event All PHP Versions included
    Tags Optional: Type a few tags separated by commas. This can help to easily find the package based on the tags you enter here. suphp, mpm event, all php
  8. Save as profile Save button highlighted

    Once you have typed all the details into each field, click the Save button.

Upload Profile

If you have previously downloaded an existing profile in the .json file format, you can simply upload the profile through the WHM/EA4 interface. Follow the steps below to upload an EA4 profile using your .json file.

  1. WHM login screen, Username root, Password field filled, and Log in button highlighted

    Log into WHM as root.

  2. Search term easy entered into WHM search field

    Type ‘easy‘ into the search field in the top left of WHM.

  3. WHM Software EasyApache 4 menu option highlighted

    Under the Software category, click on EasyApache 4.

  4. Available Profiles section Upload a profile button highlighted

    In the Available Profiles section, click on the Upload a profile button.

  5. Upload a profile pop-up Browse button highlighted

    Click on the Browse button and locate the file in your local files/directories to select it to upload.

    Upload a profile pop-up Retreive from URL button and field to type/paste URL into highlighted

    If you want to retrieve the profile over HTTP, simply click on Retrieve from URL and type/paste the URL into the field.

  6. Upload a profile Upload button highlighted

    Click the Upload button.

  7. Once the upload completes the Available Packages list will refresh and now include the profile you just uploaded.

Congratulations! You now know how to save a custom profile through the WHM/EA4 interface. If you would like to learn more about EasyApache 4, be sure to browse through our WHM Education Channel.

Leave a Reply