Skip to content
cPFenceDocs

Restart PHP containers

Use the Enhance main control panel server with a valid cPFence license and a Super admin API key. WebUI users need access to the selected websites and permission for this action.

Use this when a PHP configuration, Redis setting, or extension change requires a restart. Schedule a low-traffic window; requests can be interrupted briefly.

From the WebUI

Section titled “From the WebUI”
  1. Open Tools & Utilities → ApiMachine Bulk Tools.
  2. Choose Cluster scope or Select servers, apply your filters, then check the intended website rows. Review the selection rules; filtering alone does not select websites.
  3. Open Choose action → PHP → Restart PHP container.

PHP action menu showing Restart PHP container.

Choose Restart PHP container only for the intended websites and maintenance window. Select the image to enlarge it; use your browser's Back command to return.
  1. Review the selected websites and Confirm and run. Read Finished or Needs attention and the per-target output.

Read each target’s restart result and test normal application requests afterward.

From the terminal

Section titled “From the terminal”

Use root on the main control panel server. Generate and edit the CLI site list first so that /var/log/cpfenceav/cluster-sites-list.txt contains only your intended targets.

Terminal window
cpfence --bulk-restart-php-container

Read the target list and confirm the action when prompted.

For failures, read each target’s error and check its actual state before retrying. Keep the retry selection limited to the intended websites.