This document discusses how to create an EasyApache 4 (EA4) profile.
The system strips the prefix from the package name in the EasyApache 4 interface.
About EasyApache 4 profiles
EasyApache 4 profiles are JSON files. While EasyApache 4 provides a number of profiles that will suit most needs, you may wish to create your own to further customize your server.
To create a profile, you can download one of the provided profiles, customize it, then upload it to the server in the EasyApache 4 interface (Home >> Software >> EasyApache 4). You can also create your own by hand and either upload it or create it directly on the server.
Upload a file
The easiest way to create an EasyApache 4 profile on systems that run cPanel & WHM version 64 or higher is to create the file and then upload it in the EasyApache 4 interface (Home >> Software >> EasyApache 4). This action ensures that your profile saves to the proper location and that a file does not already exist with the selected file name. All custom profiles save to the
We strongly recommend that you download a current EasyApache 4 profile and modify it to meet your needs.
Your EasyApache 4 profile file must be a JSON file that resembles the following example:
The following table explains the above keys:
|integer||The profile's version.|
|string||The profile name that WHM displays.|
|array of strings||A list of tags that WHM displays.|
|string||A description of the profile that WHM displays.|
|array of strings||The packages in the profile.|
Create an EA4 profile directly on the server
You can upload a file from the EasyApache 4 interface on a system that runs cPanel & WHM version 64 or higher.
Navigate to the
Always save your profiles in the
/etc/cpanel/ea4/profiles/custom/directory. The system uniquely uses the
/etc/cpanel/ea4/profiles/vendordirectories. These files may work initially if you use them, but they will likely disappear or not function as you might expect.
With a text editor, create a JSON file with your preferred settings. For more information about file format, read the JSON section.
After you create the JSON file and save your changes, check for proper syntax. To do this, run the following command, where
custom_profile_name.jsonrepresents your JSON file:If the command does not return output, your JSON file's syntax is correct.
The tool accepts the following options:
-fflag passes the file's input format. For example,
-tflag passes the file's output format. For example,
-json_optflag passes format options in which to print information to the
JSON:PPmodule (for example,
For more information, read cpan.org's JSON::PP command utility documentation.
Navigate to the EasyApache 4 interface (Home >> Software >> EasyApache 4) and verify that your profile appears.
Create a default profile for a fresh cPanel & WHM install
EasyApache 4 allows you to preconfigure your profile before you install cPanel & WHM version 58 or higher on your server.
To preconfigure your profile, create the
You must create this profile as a valid JSON file and a valid EasyApache 4 profile.
The system will install this profile and then copy it to the
/etc/cpanel/ea4/profiles/custom/ directory when the system completes the installation.
If your JSON file contains errors, no data, or the installation fails, the system installs the default EasyApache 4 profile.