HaBangNet Corp

×
×

Nginx - Engintron for cPanel Server

Back

We recommend Engintron for cPanel if you're looking to install Nginx to your cPanel Server. As we tested ourself on many of our cPanel Server, and it improved alot on speed for website loading.

Nginx® is a powerful open source web server that was built to scale websites to millions of visitors. cPanel® is the leading hosting control panel worldwide.

Engintron for cPanel/WHM is the easiest way to integrate Nginx on your cPanel/WHM server.

Engintron will improve the performance & web serving capacity of your server, while reducing CPU/RAM load at the same time. It does that by installing & configuring the popular Nginx webserver to act as a reverse caching proxy for static files (like CSS, JS, images etc.) with an additional micro-cache layer to significantly improve performance for dynamic content generated by CMSs like WordPress, Joomla or Drupal as well as forum software like vBulletin, phpBB, SMF, IPB or e-commerce solutions like Magento, OpenCart, PrestaShop and others.

Requirements

A few things to keep in mind before installing Engintron.

  1. Read the Engintron Wiki section before posting questions in the "Issues" section. Seriously.
  2. As of v1.8.0, Engintron has to perform constant file operations within cPanel to make sure HTTPS works smoothly. Since Engintron is built in Bash & PHP, it's mandatory that open_basedir protection is disabled in your system. Besides, if PHP is served via PHP-FPM or running as a CGI or FastCGI module in your server, the file system's restrictions in access rights and file ownership will prevent you from having any issues with open_basedir disabled.
  3. If you use a firewall like CSF (or similar), please make sure ports 8080 and 8443 are enabled. Apache will use these when Nginx binds to ports 80 and 443 to handle HTTP and HTTPS traffic respectively.
  4. If you already had some other Nginx for cPanel plugin installed on your system, please make sure you've uninstalled it first.

Engintron is fully compatible with CentOS version 5, 6 and 7 on both 32-bit and 64-bit platforms. Additionally, users have already reported a 100% compatibility with CloudLinux versions 6 & 7.

Engintron is also compatible with both EasyApache 3 and EasyApache 4 as of version 1.7.0.

Installing Engintron for the first time

Installation is a process that lasts only a few minutes. You'll need root SSH access to your cPanel server. Also check the current requirements (listed lower). If everything is ok, log in as root and type the following commands, one at a time:

cd / rm -f engintron.sh wget --no-check-certificate https://raw.githubusercontent.com/engintron/engintron/master/engintron.sh bash engintron.sh install

Or in one quick command to paste in the terminal:

cd /; rm -f engintron.sh; wget --no-check-certificate https://raw.githubusercontent.com/engintron/engintron/master/engintron.sh; bash engintron.sh install 

The process will take a couple of minutes to complete and after that, Engintron will be installed on your cPanel server. Engintron has a nice user interface which is activated inside WHM, under the Plugins section. After installation, refresh WHM in your browser and you should see Engintron in the Plugins section (it's the absolute last section in WHM's sidebar).

In there, you'll find basic options to control Nginx, Apache and MySQL, all in one convenient place. Additionally, you can edit all of Nginx's configuration files (as well as some from Apache & MySQL) to get even more from Engintron (e.g. configure Engintron for use with CloudFlare). If however all you want is to accelerate both static & dynamic content delivery, then Engintron is already setup for you and you don't need to do anything more.

Inside the Engintron app dashboard you'll also find some handy utilities to monitor things like your Nginx access & error logs, check processes on your server or see incoming traffic on port 80.

Update (or re-install) Engintron

To re-install or update Engintron, either use Enginton's WHM app (there's a link to update/re-install Engintron) or if you prefer the terminal simply follow the same process as described in the installation section above.

HOWEVER, if you have customized any of the 5 main Nginx configuration files (nginx.conf, the 3 proxy_params_* files, default.conf), please back up your changes, so you can paste them back after the update. As of version 1.6.2, "custom_rules" is not changed on subsequent updates in order to maintain your custom Nginx configuration options like for example rules for CloudFlare. Engintron will always override the 5 configuration files mentioned earlier upon re-installation or update to ensure things always work as expected.

If for some reason you forget to do this, we got your back (shit can happen, right?). Login as root and navigate to Nginx's files to retrieve the backups of the configuration files which are automatically created when you re-install/update Engintron:

$ cd /etc/nginx $ cat nginx.conf.bak $ cat proxy_params_common.bak $ cat proxy_params_dynamic.bak $ cat proxy_params_static.bak $ cat conf.d/default.conf.bak 

This way you can view your previous changes so you can copy them to the new configuration files installed.

We HIGHLY recommend that any customizations to Nginx's configuration are only performed inside the custom_rules file. When you update Engintron, we can show you a copy of your previous "custom_rules" file so you can copy/paste or adapt any of your custom Nginx rules to the new release's "custom_rules" file.

 

More information, you can visit Engintron website


Powered by HostBill