Configure or Disable PHP-FPM with User Pools for EasyApache 4

Configure or Disable PHP-FPM with User Pools for EasyApache 4



The information in this document only pertains to cPanel & WHM version 58 and earlier.

The FastCGI Process Manager (PHP-FPM) implementation of FastCGI provides process management, emergency restarts, and IP address restriction. You must perform extra steps to use this handler with user pools on a shared server.

Set up pools per user


You can only configure one PHP-FPM pool per user.


  • These instructions assume that your server runs EasyApache 4.
  • In the examples below, the following are true:
    • ea-php56 and ea-php70 represent the versions of PHP to use.
    • <user> represents a user on the system.
    • represents the domain’s base directory.
    • <useraccount> represents the user’s account.
    • <vhost> represents the name of the virtual host.

To set up PHP-FPM for a shared server, select the tab that corresponds to your PHP version:


We introduced this feature in cPanel & WHM version 58. Do not follow this configuration process for version 60 and later.

Navitabs License Error

This license is not valid for the current version of the Navitabs plugin. You must either obtain a new license or use an older version of the plugin. Please contact your system administrator.

How to disable user pools

To disable user pools, perform the following steps:

  1. Remove the fpm.conf file from the user’s include directory with the following command:
    rm /etc/apache2/conf.d/userdata/std/2_4/$user/$domain/fpm.conf


    You must remove the directory before rebuild httpd will disable the include line.

  2. If the user’s system does not contain any other includes, remove the user’s include directory with the following command:
    rmdir /etc/apache2/conf.d/userdata/std/2_4/$user
  3. Remove the FPM user configuration file with the following command:
    rm /opt/cpanel/ea-phpxx/root/etc/php-fpm.d/$user.conf
  4. Rebuild the httpd configuration with the following command:
  5. Stop and start the FPM with the commands appropriate for your version of OS:
    CentOS 5 & 6
    /etc/init.d/ea-php56-php-fpm stop 
    /etc/init.d/ea-php56-php-fpm start
    CentOS 7
    systemctl stop ea-php56-php-fpm.service
    systemctl start ea-php56-php-fpm.service
  6. Restart Apache with the following command:
    /scripts/restartsrv httpd

Was this article helpful?

Related Articles

Leave A Comment?

You must be logged in to post a comment.