NGINX (pronounced "engine x" or "en-jin-eks") is the world's most popular Web Server, high performance Load Balancer, Reverse Proxy, API Gateway and Content Cache.

NGINX is free and open source software, distributed under the terms of a simplified 2-clause BSD-like license.

Enterprise distributions, commercial support and training are available from F5, Inc.

• How it works
  • Modules
  • Configurations
  • Runtime
• Downloading and installing
  • Stable and Mainline binaries
  • Linux binary installation process
  • FreeBSD installation process
  • Windows executables
  • Dynamic modules
• Getting started with NGINX
  • Installing SSL certificates and enabling TLS encryption
  • Load Balancing
  • Rate limiting
  • Content caching
• Building from source
  • Installing dependencies
  • Cloning the NGINX GitHub repository
  • Configuring the build
  • Compiling
  • Location of binary and installation
  • Running and testing the installed binary
• Asking questions and reporting issues
• Contributing code
• Additional help and resources
• Changelog
• License

NGINX is installed software with binary packages available for all major operating systems and Linux distributions. See Tested OS and Platforms for a full list of compatible systems.

NGINX is comprised of individual modules, each extending core functionality by providing additional, configurable features. See "Modules reference" at the bottom of nginx documentation for a complete list of official modules.

NGINX modules can be built and distributed as static or dynamic modules. Static modules are defined at build-time, compiled, and distributed in the resulting binaries. See Dynamic Modules for more information on how they work, as well as, how to obtain, install, and configure them.

nginx -V

See Configuring the build for information on how to include specific Static modules into your nginx build.

NGINX is highly flexible and configurable. Provisioning the software is achieved via text-based config file(s) accepting parameters called "Directives". See Configuration File's Structure for a comprehensive description of how NGINX configuration files work.

Rather than running in a single, monolithic process, NGINX is architected to scale beyond Operating System process limitations by operating as a collection of processes. They include:

• A "master" process that maintains worker processes, as well as, reads and evaluates configuration files.
• One or more "worker" processes that process data (eg. HTTP requests).

The number of worker processes is defined in the configuration file and may be fixed for a given configuration or automatically adjusted to the number of available CPU cores. In most cases, the latter option optimally balances load across available system resources, as NGINX is designed to efficiently distribute work across all worker processes.

Follow these steps to download and install precompiled NGINX binaries. You may also choose to build NGINX locally from source code.

NGINX binaries are built and distributed in two versions: stable and mainline. Stable binaries are built from stable branches and only contain critical fixes backported from the mainline version. Mainline binaries are built from the master branch and contain the latest features and bugfixes. You'll need to decide which is appropriate for your purposes.

The NGINX binary installation process takes advantage of package managers native to specific Linux distributions. For this reason, first-time installations involve adding the official NGINX package repository to your system's package manager. Follow these steps to download, verify, and install NGINX binaries using the package manager appropriate for your Linux distribution.

Future upgrades to the latest version can be managed using the same package manager without the need to manually download and verify binaries.

For more information on installing NGINX on FreeBSD system, visit https://nginx.org/en/docs/install.html

Windows executables for mainline and stable releases can be found on the main NGINX download page. Note that the current implementation of NGINX for Windows is at the Proof-of-Concept stage and should only be used for development and testing purposes. For additional information, please see nginx for Windows.

NGINX version 1.9.11 added support for Dynamic Modules. Unlike Static modules, dynamically built modules can be downloaded, installed, and configured after the core NGINX binaries have been built. Official dynamic module binaries are available from the same package repository as the core NGINX binaries described in previous steps.

For a gentle introduction to NGINX basics, please see our Beginner’s Guide.

See Configuring HTTPS servers for a quick guide on how to enable secure traffic to your NGINX installation.

For a quick start guide on configuring NGINX as a Load Balancer, please see Using nginx as HTTP load balancer.

See our Rate Limiting with NGINX blog post for an overview of core concepts for provisioning NGINX as an API Gateway.

See A Guide to Caching with NGINX and NGINX Plus blog post for an overview of how to use NGINX as a content cache (e.g. edge server of a content delivery network).

The following steps can be used to build NGINX from source code available in this repository.

Most Linux distributions will require several dependencies to be installed in order to build NGINX. The following instructions are specific to the apt package manager, widely available on most Ubuntu/Debian distributions and their derivatives.

sudo apt update

Use the following command to install the GNU C compiler and Make utility.

sudo apt install gcc make

sudo apt install libpcre3-dev zlib1g-dev

sudo apt install libssl-dev

Using your preferred method, clone the NGINX repository into your development directory. See Cloning a GitHub Repository for additional help.

git clone https://github.com/nginx/nginx.git

Prior to building NGINX, you must run the configure script with appropriate flags. This will generate a Makefile in your NGINX source root directory that can then be used to compile NGINX with options specified during configuration.

From the NGINX source code repository's root directory:

auto/configure

The configure script will generate a Makefile in the NGINX source root directory upon successful execution. To compile NGINX into a binary, issue the following command from that same directory:

make

After successful compilation, a binary will be generated at <NGINX_SRC_ROOT_DIR>/objs/nginx. To install this binary, issue the following command from the source root directory:

sudo make install

To run the installed binary, issue the following command:

sudo /usr/local/nginx/sbin/nginx

You may test NGINX operation using curl.

curl localhost

The output of which should start with:

<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>

We encourage you to engage with us.

• NGINX GitHub Discussions, is the go-to place to start asking questions and sharing your thoughts.
• Our GitHub Issues page offers space to submit and discuss specific issues, report bugs, and suggest enhancements.

Please see the Contributing guide for information on how to contribute code.

• See the NGINX Community Blog for more tips, tricks and HOW-TOs related to NGINX and related projects.
• Access nginx.org, your go-to source for all documentation, information and software related to the NGINX suite of projects.

See our changelog to keep track of updates.

2-clause BSD-like license

Additional documentation available at: https://nginx.org/en/docs