Knowledge Base

How to use NginxCP with custom modules (naxsi, etc..)

08-10-2012, 05:25 PM

If you are installing nginx on a Cpanel server using NginxCP, it's possible that you need to compile a custom module like naxsi. You can't do this through NginxCP's configure file, for some reason it does not work. Below are the steps to be taken to add the module correctly.

1. Download and install nginxcp per the instructions on www.nginxcp.com.
2. In order to add something like naxsi, you essentially have to reinstall nginx on top of the existing version of nginx that was installed by Nginxcp. 
3. Follow the instructions here: http://code.google.com/p/naxsi/wiki/Howto. Download the latest stable versions of naxsi and nginx.
4. Untar nginx and install it using the following options (just make sure the path and the version of naxsi are correct):
 

Code:

--with-pcre=/usr/local/src/publicnginx/pcre-8.30 --sbin-path=/usr/local/sbin --conf-path=/etc/nginx/nginx.conf --pid-path=/var/run/nginx.pid --add-module=../naxsi-0.47/naxsi_src/ --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --with-http_realip_module --with-http_ssl_module --http-client-body-temp-path=/tmp/nginx_client --http-proxy-temp-path=/tmp/nginx_proxy --http-fastcgi-temp-path=/tmp/nginx_fastcgi --with-http_stub_status_module

Notice that we added the '--add-module=../naxsi-0.47/naxsi_src/' line to the configure command. When you run it, it will then compile nginx with naxsi support and the NginxCP plugin will still work with the new/updated version of nginx and any custom modules you compiled in. 

Now you just have to follow the how-to for Naxsi (in this case) and finish configuring it.