NGHTTPD(1)

NAME
nghttpd - HTTP/2 server

SYNOPSIS

nghttpd [OPTION]... <PORT> [<PRIVATE_KEY> <CERT>]

DESCRIPTION

HTTP/2 server

<PORT>
    Specify listening port number.

<PRIVATE_KEY>
    Set path to server's private key. Required unless --no-tls is specified.

<CERT>
    Set path to server's certificate. Required unless --no-tls is specified.

OPTIONS

-a, --address=<ADDR>
    The address to bind to. If not specified the default IP address determined by getaddrinfo is used.

-D, --daemon
    Run in a background. If -D is used, the current working directory is changed to '/'. Therefore if this option is used, -d option must be specified.

-V, --verify-client
    The server sends a client certificate request. If the client did not return a certificate, the handshake is terminated. Currently, this option just requests a client certificate and does not verify it.

-d, --htdocs=<PATH>
    Specify document root. If this option is not specified, the document root is the current working directory.

-v, --verbose
    Print debug information such as reception/ transmission of frames and name/value pairs.

--no-tls
    Disable SSL/TLS.

-c, --header-table-size=<SIZE>
    Specify decoder header table size.

--color
    Force colored log output.

-p, --push=<PATH>=<PUSH_PATH,...>
    Push resources <PUSH_PATH>s when <PATH> is requested. This option can be used repeatedly to specify multiple push configurations. <PATH> and <PUSH_PATH>s are relative to document root. See --htdocs option. Example: -p/=/foo.png -p/doc=/bar.css

-b, --padding=<N>
    Add at most <N> bytes to a frame payload as padding. Specify 0 to disable padding.

-m, --max-concurrent-streams=<N>
    Set the maximum number of the concurrent streams in one HTTP/2 session.

    Default: 100

-n, --workers=<N>
    Set the number of worker threads.

    Default: 1

-e, --error-gzip
    Make error response gzipped.

-w, --window-bits=<N>
    Sets the stream level initial window size to 2**<N>-1.

-W, --connection-window-bits=<N>
    Sets the connection level initial window size to 2**<N>-1.

--dh-param-file=<PATH>
    Path to file that contains DH parameters in PEM format. Without this option, DHE cipher suites are not available.

--early-response
    Start sending response when request HEADERS is received, rather than complete request is received.

--trailer=<HEADER>
    Add a trailer header to a response. <HEADER> must not include pseudo header field (header field name starting with ':'). The trailer is sent only if a response has body part. Example: --trailer 'foo: bar'.

--hexdump
    Display the incoming traffic in hexadecimal (Canonical hex+ASCII display). If SSL/TLS is used, decrypted data are used.

--echo-upload
    Send back uploaded content if method is POST or PUT.

--mime-types-file=<PATH>
    Path to file that contains MIME media types and the extensions that represent them.

    Default: /etc/mime.types

--no-content-length
    Don't send content-length header field.

--version
    Display version information and exit.

-h, --help
    Display this help and exit.

    The <SIZE> argument is an integer and an optional unit (e.g., 10K is 10 * 1024). Units are K, M and G (powers of 1024).

SEE ALSO

nghttp(1), nghttpx(1), h2load(1)

AUTHOR
Tatsuhiro Tsujikawa

COPYRIGHT
2012, 2015, 2016, Tatsuhiro Tsujikawa