Setting up Nginx to work over a Unix file socket

(written by lawrence krubner, however indented passages are often quotes). You can contact lawrence at:

This is the best article I’ve ever read on setting up Nginx.

Preface :
To begin and preface this article, this is the exact stack that I am running and I have set this up on a Rackspace Cloud Server. So I know that it is portable and will work on a multitude of different environments. Secondly I know that it works, I know this because the article you are reading was published on a site using it. Furthermore, I have spent several Days working out the bugs and some of the possible issues that can come up with using this type of setup. and I have attempted to comment the different configuration files that I will be showing so that you can make changes to fit your environment. To that end, I will be showing the entire configuration for the server and some of the other things that I have been able to come up with as I have not found anywhere on the whole of the Internet, and believe me I have looked, on how I set this up.

To being here are the specs that I started with

Rackspace Cloud Server.
Operating System : Debian 6
Flavor : 256 MB Ram
It should be noted, while I am a Debian guy, I also have love for my RHEL Brothers too. This guide is specifically for Debian, though it can be used in a RHEL setup, you simply need to make a few changes to the placement of the files that you are modifying, you will also need to use other repositories for your packages, or compile your service from source.

Once the server is provisioned and you have been able to login to the server, I recommend that you do any and all patching. To do this enter this simple command set :

aptitude update
aptitude dist-upgrade
Once you have finished updating this set will allow you to restart the server; this ensures that the updates have been installed and initialized completely.

This is where the fun Begins…
It is now time to get your system ready to install NGINX and PHP-FPM.

You can get the source from NGINX and or add the NGINX repositories to your system. There is a Debian specific Repository that you could use, there are also other Distro specific Repositories that you could use if you system happens to not be a Debian Server. You can find more information on these repositories here : NGINX Repositories

While the for-mentioned REPO is perfectly valid, I choose to use the Debian Backports as my repository for NGINX. I chose this because this allowed for an easy configuration, and allowed me to install a more up-to-date version of NGINX on my system while giving me a more supported application for my environment. To add the Debian Backports to your repositories simply execute this echo command:

echo ‘deb squeeze-backports main’ >> /etc/apt/sources.list.d/backports.list
after this has been added to your Source Repositories you will then need to add the DotDeb Repositories to your system so that you can install PHP-FPM.

I would like to just take a minute to make a shout out to the people over at DotDeb. You people are what make the Open Source Community a great place to develop. Thank you! You can read more about DotDeb and their repositories here.

To install the DotDeb Repositories into your system here is a crazy little command set :

echo ‘deb stable all’ >> /etc/apt/sources.list.d/DotDeb.list
echo ‘deb-src stable all’ >> /etc/apt/sources.list.d/DotDeb.list
cat dotdeb.gpg | sudo apt-key add -; rm dotdeb.gpg
This set adds the DotDeb Repositories to your sources, it then adds the GPG key to your system , and finally it removes the GPG key file from your system; so there are no left overs from the installation.

After you have added the repositories to your system, update your sources with this simple command :

aptitude update
Installing NGINX & PHP-FPM…
Now this is the most complicated and quite possibly the hardest piece to this setup.

Here is the overwhelimg and complicate command set that you will need to enter in order to get NGINX and PHP-FPM installed on your Debian System.

aptitude -t squeeze-backports install nginx-extras; aptitude install php5 php5-fpm php5-common php5-curl php5-dev php5-gd php5-imagick php5-mcrypt php5-memcache php5-mhash php5-mysql php5-pspell php5-snmp php5-sqlite php5-xmlrpc php5-xsl php-pear libssh2-php php5-cli
At this time I create a system user for NGINX.

adduser –system –no-create-home nginx
This command simply creates a system user with no home directory. We will use this User later in our setup.

WOW! that was tough!

Well now that is out of the way we can proceed to setting up NGINX and PHP-FPM to work on your system.

Setup for NGINX…
If you are coming from the world of Apache, NGINX will look like Chinese to you. Though you will see that there are some familiar directives and you will see some things that you may recognize. Though I would implore you to go to the NGINX Wiki and read on how things are done in NGINX. Essentially if it does not work right, it is because you did it wrong. Now that might sound harsh though it is the truth. NGINX is stupid simple, and one of the things that I had the hardest time with; was realizing that there was no need for complicated nonsense in my setup. NGINX allows you to change the outlook on your web application from complication to simplicity. So like Steve Jobs used to always say, “It just Works.”

In NGINX everything that you will need to mess with is in the directory /etc/nginx. So for this part of the guide go to the directory /etc/nginx and it is here that we will begin changing the configuration files.

There are several Files that are default that you will have to concern yourself with, and then a few others that I created so that I can use in my deployment of Virtual Hosts.

Default Files nginx.conf fastcgi_params Files that I made to simplify my life security mail.conf Before we go crazy and start deleting files and changing functions I recommend that we make a backup for the core files. Here is how you can do this simply and fast.

tar -czf ~/NGINX_Config.tar.gz nginx.conf fastcgi_params
Here is the nginx.conf that I have setup for my System. This can be modified to fit the needs of your environment though this should be good enough for most Production Systems.

user nginx www-data;
worker_processes 4;
pid /var/run/;

events {
worker_connections 768;
# multi_accept on;

http {
# Basic Settings
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 65;
types_hash_max_size 2048;
# server_tokens off;

# server_names_hash_bucket_size 64;
# server_name_in_redirect off;

include /etc/nginx/mime.types;
default_type application/octet-stream;

# Logging Settings
log_format gzip ‘$remote_addr – $remote_user [$time_local] ‘
‘”$request” $status $bytes_sent ‘
‘”$http_referer” “$http_user_agent” “$gzip_ratio”‘;

access_log /var/log/nginx/access.log gzip buffer=32k;
error_log /var/log/nginx/error.log notice;

# Gzip Settings
gzip on;
gzip_disable “msie6″;

gzip_vary on;
gzip_proxied any;
gzip_comp_level 6;
gzip_buffers 16 8k;
gzip_http_version 1.1;
gzip_types text/plain text/css application/json application/x-javascript text/xml application/xml application/xml+rss text/javascript;

# Virtual Host Configs
include /etc/nginx/conf.d/*.conf;
include /etc/nginx/sites-enabled/*;

Here is the fastcgi_params

fastcgi_param QUERY_STRING $query_string;
fastcgi_param REQUEST_METHOD $request_method;
fastcgi_param CONTENT_TYPE $content_type;
fastcgi_param CONTENT_LENGTH $content_length;

fastcgi_param SCRIPT_NAME $fastcgi_script_name;
fastcgi_param REQUEST_URI $request_uri;
fastcgi_param DOCUMENT_URI $document_uri;
fastcgi_param DOCUMENT_ROOT $document_root;
fastcgi_param SERVER_PROTOCOL $server_protocol;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param PATH_INFO $fastcgi_script_name;

fastcgi_param GATEWAY_INTERFACE CGI/1.1;
fastcgi_param SERVER_SOFTWARE nginx/$nginx_version;

fastcgi_param REMOTE_ADDR $remote_addr;
fastcgi_param REMOTE_PORT $remote_port;
fastcgi_param SERVER_ADDR $server_addr;
fastcgi_param SERVER_PORT $server_port;
fastcgi_param SERVER_NAME $server_name;

# PHP only, required if PHP was built with –enable-force-cgi-redirect
fastcgi_param REDIRECT_STATUS 200;
Those were the two basic files that you have to use to setup NGINX. Now here are the custom configs that I added to simplify my life.

Now I setup a security file, to fend off some basic annoyances. This is the security file.

## Only requests to our Host are allowed
# if ($host !~ ^($server_name)$ ) {
# return 444;
# }

## Only allow these request methods ##
## Do not accept DELETE, SEARCH and other methods ##
if ($request_method !~ ^(GET|HEAD|POST)$ ) {
return 444;

## Deny certain Referers ###
if ( $http_referer ~* (babes|forsale|girl|jewelry|love|nudit|organic|poker|porn|sex|teen) )
return 404;
return 403;
Finally I setup a file for the mail directives that are normally in the nginx.conf file. I place these commented out lines in a mail.conf“file in the “/etc/nginx/conf.d/ folder and I leave the lines all commented out. I do this so that I could use it in the future if I ever choose to, though I am fairly sure that I wont. Essentially this part is optional and not necessary. The file created is mail.conf and it should be placed in the /etc/nginx/conf.d/ directory.

#mail {
# # See sample authentication script at:
# #
# # auth_http localhost/auth.php;
# # pop3_capabilities “TOP” “USER”;
# # imap_capabilities “IMAP4rev1″ “UIDPLUS”;
# server {
# listen localhost:110;
# protocol pop3;
# proxy on;
# }
# server {
# listen localhost:143;
# protocol imap;
# proxy on;
# }
Now that you have the basic NGINX configuration out of the way, it is time to setup some Virtual Hosts. In Debian there are two directories that are in the /etc/nginx/ directory. These are sites-available and sites-enabled. The functions for these directories are fairly straight forward. One is the place you house your Virtual Hosts, and the other is where the active Virtual Hosts live. Essentially if you are familiar with Apache, this has the same functionality. You have a Virtual Host Config file in the available directory and you either copy or Symlink the files from one place to the other. To symlink a Virtual Host Config File from one Directory to another you will enter this command.

ln -s /etc/nginx/sites-available/THE.VIRTUAL.HOST.FILENAME /etc/nginx/sites-enabled/THE.VIRTUAL.HOST.FILENAME
As you build your Virtual Hosts I recommend that you do this from within the directory /etc/nginx/sites-available. So for this portion of the guide go to the /etc/nginx/sites-available directory.