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


This document explains how to install or uninstall EasyApache 4 with the /scripts/migrate_ea3_to_ea4 script.


Operating systems

In cPanel & WHM version 56 and later, EasyApache 4 supports all of cPanel & WHM's supported operating systems.

Apache and PHP

EasyApache 4 only supports Apache version 2.4.

EasyApache 4 supports PHP versions 5.4, 5.5, 5.6, 7.0, 7.1, and 7.2.


You must activate the RPMUP setting if you install EasyApache 4 on your system. The system enables this setting by default. To do this, perform one of the following steps:

How to install EasyApache 4

To install EasyApache 4, perform the following steps on the command line as the root user:

  1. Run the following command:

    /scripts/migrate_ea3_to_ea4 --run


    • If your system runs CloudLinux, the migrate_ea3_to_ea4 script downloads and runs CloudLinux's EasyApache 4 migration script.
    • If your system runs CloudLinux, you cannot use options (for example, the --install_profile option) with the EasyApache 4 migration script.
    • As the migration script runs, the /scripts/migrate_ea3_to_ea4 script copies the /usr/local/lib/php.ini file to the /opt/cpanel/ea-php??/root/etc/php.d/php.ini file and to all installed ea-php versions on your server. To prevent complications, the system comments out lines that resemble the following lines:
      • extension=
      • extension_dir=
      • zend_extension-
    • The system does not adjust any other lines.
  2. The interface displays the changes that will occur. To continue, follow the system's instructions. 


The /scripts/migrate_ea3_to_ea4 script accepts the following arguments:


Run the script.


You must include the --run option.

--helpDisplay the help information.
--revertRevert the system to the previous version and configuration.
--skip_convertDo not convert and install the EasyApache 3 profile. This flag installs the EasyApache 4 cPanel Default Profile unless you use the --install_profile flag.

Do not convert the EasyApache 3 profile. Instead, install the specified profile.

 /scripts/migrate_ea3_to_ea4 --run --install_profile /path/to/profile

When you convert an EasyApache 3 profile to an EasyApache 4 profile, this flag prevents execution of the script's error-correction code.


This may cause a failure when you provision your system. However, you may wish to use this flag for tests.

-y | --y | -yes | --yes

Answer yes to all of the script's yes-or-no questions.

When you add the --force argument to the --run or --revert arguments, the system ignores the protection checks.


 This may cause a failure when you provision your system.

--reinstallYum attempts to install the required EasyApache 4 RPMs and attempts to reinstall any currently-installed EasyApache 4 packages.

How to uninstall EasyApache 4


You can only uninstall EasyApache 4 if you migrated your system from EasyApache 3.  

To uninstall EasyApache 4, perform the following steps on the command line as the root user:

  1. To revert to EasyApache 3 from EasyApache 4, run the following command:

    /scripts/migrate_ea3_to_ea4 --revert --run


    • This command reverts the system to your previous EasyApache 3 installation and configuration.
    • This command attempts to move the Apache files to a new location and reverts the server to the previous state. You can upgrade and downgrade as many times as you wish. 


    • Each time that you perform a migration from EasyApache 3 to EasyApache 4, the system moves the /usr/local/apache/ directory to the /usr/local/apache.ea3/ directory.
      • If the  /usr/local/apache.ea3 directory exists, the system moves the /usr/local/apache/ directory to the /usr/local/apache.ea3.1/ directory.
      • If the /usr/local/apache.ea3.1 directory exists when you run a migration, the migration will fail in order to prevent loss of data.
    • The chance of errors dramatically increases if you migrate your system multiple times. If you revert several times, you must manually delete the previous /usr/local/apache.ea3.1/ backup directory to continue. The system automatically preserves the /usr/local/apache/ directory.
  2. Follow the system's instructions.  

Additional documentation