Before we get started
If you are running Mac OS X Snow Leopard (version 10.6.x), please refer to this article: Nginx on Mac OS X Snow Leopard in 2 Minutes. You may use newer versions of Nginx and the prerequisite software, but whether you choose to do so, or you stick to the packages outlined in the above article, you will get a working Nginx web server on you Mac. Please note that the included build script will still work on Snow Leopard if you don’t want to go the DIY (do it yourself) route.
This guide will show you how I compiled a basic version of Nginx 1.1.4 on Mac OS X 10.7.1 Lion. The “2 minute” compilation that I mention in the title of this article is when using the script that I provide below. For the DIY folks, I’m breaking down the steps. Variations in your Mac’s specs, and your copy and paste skills may increase the total time to over 2 minutes.
First, if you do not already have it installed, download and install Xcode from the Mac App Store.
Nginx requires PCRE – Perl Compatible Regular Expressions to build, I used PCRE version 8.13. In a Terminal, run:
sudo curl -OL h ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/pcre-8.13.tar.gz > /usr/local/src/pcre-8.13.tar.gz
sudo mkdir -p /usr/local/src
tar xvzf pcre-8.13.tar.gz
sudo make install
(You should still be in
/usr/local/src, if you followed along from above.)
tar xvzf nginx-1.1.4.tar.gz
./configure --prefix=/usr/local --with-http_ssl_module
sudo make install
Assuming that you have
/usr/local in your $PATH (
which nginx should say:
/usr/local/sbin/nginx), you can simply run:
Note: to add
/usr/local to your $PATH variable, edit or create
~/.profile to include it. For reference, mine currently looks like this:
PATH="/usr/bin:/bin:/usr/sbin:/sbin:/usr/local:/usr/local/sbin:/usr/local/bin:/usr/X11/bin:/opt/X11/bin" – I emphasized in bold type what you need to add to your PATH.
The 2 Minute way, using my script
All of the above instructions, in a nice little script. Save it to your Mac as build-nginx.sh, open a new Terminal window and run:
chmod a+x build-nginx.sh
It’s a pretty quick process to get Nginx installed nicely on your Mac, especially if you use my script. This provides a very basic install, but it should get you moving in the right direction. Your feedback is appreciated, so leave a comment below.