nghttpd (1) Linux Manual Page

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.

–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

Index