# nginx(8) - man - phpMan

[NGINX(8)](https://www.chedong.com/phpMan.php/man/NGINX/8/markdown)                  BSD System Manager's Manual                 [NGINX(8)](https://www.chedong.com/phpMan.php/man/NGINX/8/markdown)

## NAME
     **nginx** — HTTP and reverse proxy server, mail proxy server

## SYNOPSIS
     **nginx** [**-?hqTtVv**] [**-c** _file_] [**-g** _directives_] [**-p** _prefix_] [**-s** _signal_]

## DESCRIPTION
     **nginx** (pronounced “engine x”) is an HTTP and reverse proxy server, a mail proxy server, and a
     generic TCP/UDP proxy server.  It is known for its high performance, stability, rich feature
     set, simple configuration, and low resource consumption.

     The options are as follows:

     **-?**, **-h**         Print help.

### -c

### -g

### -p

### -q

### -s
                    **quit**, **reopen**, **reload**.  The following table shows the corresponding system sig‐
                    nals:

                    **stop**    SIGTERM
                    **quit**    SIGQUIT
                    **reopen**  SIGUSR1
                    **reload**  SIGHUP

### -T -t

### -t
                    file syntax and then tries to open files referenced in the configuration file.

### -V

### -v

## SIGNALS
     The master process of **nginx** can handle the following signals:

     SIGINT, SIGTERM  Shut down quickly.
     SIGHUP           Reload configuration, start the new worker process with a new configuration,
                      and gracefully shut down old worker processes.
     SIGQUIT          Shut down gracefully.
     SIGUSR1          Reopen log files.
     SIGUSR2          Upgrade the **nginx** executable on the fly.
     SIGWINCH         Shut down worker processes gracefully.

     While there is no need to explicitly control worker processes normally, they support some sig‐
     nals too:

     SIGTERM          Shut down quickly.
     SIGQUIT          Shut down gracefully.
     SIGUSR1          Reopen log files.

## DEBUGGING LOG
     To enable a debugging log, reconfigure **nginx** to build with debugging:

           ./configure --with-debug ...

     and then set the **debug** level of the _error_log_:

           error_log /path/to/log debug;

     It is also possible to enable the debugging for a particular IP address:

           events {
                   debug_connection 127.0.0.1;
           }

## ENVIRONMENT
     The NGINX environment variable is used internally by **nginx** and should not be set directly by
     the user.

## FILES
     /run/nginx.pid
             Contains the process ID of **nginx**.  The contents of this file are not sensitive, so it
             can be world-readable.

     /etc/nginx/nginx.conf
             The main configuration file.

     /var/log/nginx/error.log
             Error log file.

## EXIT STATUS
     Exit status is 0 on success, or 1 if the command fails.

## EXAMPLES
     Test configuration file _~/mynginx.conf_ with global directives for PID and quantity of worker
     processes:

           nginx -t -c ~/mynginx.conf \
                   -g "pid /var/run/mynginx.pid; worker_processes 2;"

## SEE ALSO
     Documentation at _<http://nginx.org/en/docs/_>.

     For questions and technical support, please refer to _<http://nginx.org/en/support.html_>.

## HISTORY
     Development of **nginx** started in 2002, with the first public release on October 4, 2004.

## AUTHORS
     Igor Sysoev <<igor@sysoev.ru>>.

     This manual page was originally written by Sergey A. Osokin <<osa@FreeBSD.org.ru>> as a result of
     compiling many **nginx** documents from all over the world.

BSD                            December 5, 2019                            BSD