nghttpd(1) nghttp2 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.
--encoder-header-table-size=<SIZE>
Specify encoder header table size. The decoder (client)
specifies the maximum dynamic table size it accepts. Then
the negotiated dynamic table size is the minimum of this option
value and the value which client specified.
--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.
--groups=<GROUPS>
Specify the supported groups.
Default: X25519:P-256:P-384:P-521
--ktls Enable ktls.
--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
1.68.0 October 25, 2025 nghttpd(1)
nghttp2 1.68.0 - Generated Sat Oct 25 07:13:29 CDT 2025