Page Discussion History


Revision as of 20:33, 1 May 2012 by Admin (Talk | contribs)


Installing Modules

Nginx modules must be selected during compile, run time including of modules is not supported. A full summary of the compile-time options, including optional modules can be found in the provided configure script by running "./configure --help"

Nginx core modules

These modules are required.

Name Description
Main Configure error logging, processes, permissions, etc.
Events Configure epoll, kqueue, select, poll, etc.

Standard HTTP modules

These modules are automatically compiled in unless explicitly disabled with configure.

Name Description Version configure argument to disable
Core Control ports, locations, error pages, aliases, and other essentials. --without-http
Access Allow/deny based on IP address. --without-http_access_module
Auth Basic Basic HTTP authentication. --without-http_auth_basic_module
Auto Index Generates automatic directory listings. --without-http_autoindex_module
Browser Interpret "User-Agent" string. --without-http_browser_module
Charset Recode web pages. --without-http_charset_module
Empty GIF Serve a 1x1 image from memory. --without-http_empty_gif_module
FastCGI FastCGI Support. --without-http_fastcgi_module
Geo Set config variables using key/value pairs of IP addresses. --without-http_geo_module
Gzip Gzip responses. --without-http_gzip_module
Headers Set arbitrary HTTP response headers.
Index Controls which files are to be used as index.
Limit Requests Limit frequency of connections from a client. 0.7.20 --without-http_limit_req_module
Limit Zone Limit simultaneous connections from a client. Deprecated in 1.1.8, use Limit Conn Instead. --without-http_limit_zone_module
Limit Conn Limit concurrent connections based on a variable. --without-http_limit_conn_module
Log Customize access logs.
Map Set config variables using arbitrary key/value pairs. --without-http_map_module
Memcached Memcached support. --without-http_memcached_module
Proxy Proxy to upstream servers. --without-http_proxy_module
Referer Filter requests based on Referer header. --without-http_referer_module
Rewrite Request rewriting using regular expressions. --without-http_rewrite_module
scgi scgi protocol support. 0.8.42 --without-http_scgi_module
Split Clients Splits clients based on some conditions 0.8.37 --without-http_split_clients_module
SSI Server-side includes. --without-http_ssi_module
Upstream For load-balancing. --without-http_upstream_ip_hash_module (ip_hash directive only)
User ID Issue identifying cookies. --without-http_userid_module
uwsgi uwsgi protocol support. 0.8.40 --without-http_uwsgi_module
X-Accel X-Sendfile-like module.

Optional HTTP modules

The following modules must be enabled at compile-time with the specified option to configure.

Name Description Version configure argument to enable
Addition Append text to pages. --with-http_addition_module
Degradation Allow to return 204 or 444 code for some locations on low memory condition. 0.8.25 --with-http_degradation_module
Embedded Perl Use Perl in Nginx config files. --with-http_perl_module
FLV Flash Streaming Video --with-http_flv_module
GeoIP Creates variables with information from the MaxMind GeoIP binary files. 0.8.6, 0.7.63 --with-http_geoip_module
Google Perftools Google Performance Tools support. 0.6.29 --with-google_perftools_module
Gzip Precompression Serves precompressed versions of static files. 0.6.23 --with-http_gzip_static_module
Image Filter Transform images with Libgd 0.7.54 --with-http_image_filter_module
MP4 Enables mp4 streaming with seeking ability. 1.1.3, 1.0.7 --with-http_mp4_module
Random Index Randomize directory indexes. 0.7.15 --with-http_random_index_module
Real IP For using nginx as backend --with-http_realip_module
Secure Link Protect pages with a secret key. 0.7.18 --with-http_secure_link_module
SSL HTTPS/SSL support. --with-http_ssl_module
Stub Status View server statistics. --with-http_stub_status_module
Substitution Replace text in pages --with-http_sub_module
WebDAV WebDAV pass-through support. --with-http_dav_module
XSLT Post-process pages with XSLT. 0.7.8 --with-http_xslt_module

Mail modules

Name Description configure argument
Core Nginx is able to handle and proxy the IMAP, POP3, SMTP protocols. --with-mail
Auth Use Nginx to authenticate mail services.
Proxy Nginx can proxy IMAP, POP3, and SMTP protocols.
SSL This module ensures SSL/TLS support for POP3/IMAP/SMTP. --with-mail_ssl_module

Third party modules and Patches

Please see the catalog of 3rd party modules.