Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
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 de-
	    termined 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.    Cur-
	    rently,   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  docu-
	    ment 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  op-
	    tion   can	be used repeatedly  to specify multiple push  configura-
	    tions.    <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 ses-
	    sion.

	    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.69.0				  Apr 19, 2026			      NGHTTPD(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nghttpd&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help