Converting from EasyApache 3 to EasyApache 4

EasyApache is the name of the cPanel system that installs and updates the Apache web server on supported operating systems.

If you are using an older version of cPanel, here is how to migrate from EasyApache 3 to EasyApache 4.

Converting from Within WHM

Follow these directions if you prefer to try the conversion from WHM.

1. Log into WHM as root. Typically you can do this by accessing https://YOURSERVERNAME.COM/whm (Replace YOURSERVERNAME.COM with the sever’s hostname or your server’s main IP address.)
2. Check to see if you are still using EasyApache 3 by selecting EasyApache 3 from the Software section of the WHM sidebar on the left. If you don’t see that option, you either aren’t logged in as root to WHM or your server is already converted to EasyApache 4 or you are using cPanel v52-58,
3. If you are using EasyApache 3, you will see an EasyApache 4 Migration link near the top of the screen. Click on it.
4. The system will walk you through the process of converting to EasyApache 4.
5. The tool will warn you about any conditions that stop the conversion from happening. If so, address any reported concerns and try again.
6. When complete, check your websites to make sure they work as expected.
   1. Errors after conversion are most often caused by incorrect directives in .htaccess files. Try removing any PHP directives from there or any custom php.ini files and then try setting the needed PHP options in that domain’s cPanel account instead.

Converting from the SSH Shell (Command Line)

You could also choose to handle the conversion to EasyApache 4 from the shell when you are logged into SSH as the root user.

1. Log into SSH as root to the server you want to convert.

2. Execute the following command:

   Convert EA3 to EA4

   /usr/local/cpanel/scripts/migrate_ea3_to_ea4 --run

3. The tool will warn you about any conditions that stop the conversion from happening. If so, address any reported concerns and try again.
4. The conversion process will begin.
5. When complete, check your websites to make sure they work as expected.
   1. Errors after conversion are most often caused by incorrect directives in .htaccess files. Try removing any PHP directives from there or any custom php.ini files and then try setting the needed PHP options in that domain’s cPanel account instead.