How to Install NginxCP (Nginx Admin) on cPanel/WHM – Full Guide (2026)

What Is NginxCP (Nginx Admin) and Why Use It on cPanel?

NginxCP, also known as Nginx Admin, is a free plugin that integrates Nginx with cPanel/WHM as a reverse proxy in front of Apache. It serves static content (images, CSS, JS) directly through Nginx while Apache continues handling dynamic requests (PHP, CGI), which reduces server load and speeds up page delivery without replacing your existing Apache/cPanel stack.

 

This guide covers the full installation process, how to verify it worked, how to uninstall it safely, and what to check if the install script fails.

Before You Start: Requirements

• A cPanel/WHM server with root SSH access
• WHM's Remote Access Key generated (Home » Clusters » Remote Access Key)
• A recent backup or snapshot, since NginxCP modifies your Apache/vhost configuration
• Enough free disk space in /usr/local/src

How to Install NginxCP on cPanel/WHM

Connect to your server via SSH as root, then run the following commands one at a time:

cd /usr/local/src
wget http://nginxcp.com/latest/nginxadmin.tar
tar xf nginxadmin.tar
cd publicnginx
./nginxinstaller install

The installer will detect your existing Apache setup, generate the Nginx configuration for each domain on the server, and register itself as a plugin in WHM. Once it finishes, restart Apache to complete the setup.

Generate the Remote Access Key (if the installer asks for one)

If you see an error like "Remote Access Key does not exist," the installer needs a WHM remote access key before it can proceed:

1. Log in to WHM
2. Go to Clusters » Remote Access Key
3. Click Generate New Key
4. Re-run ./nginxinstaller install

How to Verify the NginxCP Installation

Once the script completes, confirm everything is working before moving on:

• In WHM, go to Plugins » Nginx Admin — this menu should now be visible
• Check that the Nginx configuration file exists (typically under /etc/nginx/ or /usr/local/nginx/conf/)
• Confirm Nginx is listening on port 80/443 alongside Apache: netstat -tulpn | grep nginx
• Load a site on the server and check response headers for the Nginx signature on static assets

How to Uninstall NginxCP

If you need to roll back, the process mirrors the install. Run:

cd /usr/local/src
wget http://nginxcp.com/latest/nginxadmin.tar
tar xf nginxadmin.tar
cd publicnginx
./nginxinstaller uninstall

Important: uninstalling has been known to leave Apache's configuration needing a manual check afterward. Verify Apache starts cleanly and serves all domains correctly once the uninstall finishes — don't assume it's clean without checking.

Common Issues When Installing NginxCP

• "Remote Access Key does not exist" — generate a new key in WHM as shown above and re-run the installer.
• New domains not picked up automatically — NginxCP typically needs a manual "Rebuild Configuration" from WHM's Nginx Admin page after adding a domain.
• Nginx stops unexpectedly under load — a quick service nginx restart usually resolves it; if it recurs, review your Nginx error logs for the root cause.
• Apache needs repair after uninstall — check httpd -t for config errors and restart Apache before assuming the rollback is complete.

Is NginxCP Still a Good Choice in 2026?

NginxCP is still functional and free, and plenty of admins run it in production without issues. That said, it's a smaller, less frequently updated project compared to newer alternatives. If you're setting up a new server rather than maintaining an existing NginxCP install, it's worth comparing it against Engintron, a more actively maintained free Nginx-reverse-proxy plugin for cPanel, or evaluating a full move to a modern control panel if Apache/cPanel licensing costs are also a concern.

FAQ

Does NginxCP replace Apache?
No. NginxCP runs Nginx as a reverse proxy in front of Apache — Apache keeps handling PHP and dynamic content, while Nginx serves static files.

Is NginxCP free?
Yes, it's a free plugin with no license fee.

Do I need to rebuild the configuration after adding a new domain?
Yes. NginxCP doesn't always auto-detect new vhosts — rebuild the Nginx configuration from WHM's Nginx Admin page after adding a domain.

What do I do if uninstalling breaks Apache?
Run httpd -t to check for configuration errors, then restart Apache. Keep a backup of your vhost configs before uninstalling so you can restore them if needed.