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

FreeBSD Manual Pages

  
 
  

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
	      determined by getaddrinfo	is used.

       -D, --daemon
	      Run  in a	background.  If	-D is used, the	current	working	direc-
	      tory 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)	speci-
	      fies   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	  con-
	      figurations.     <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.	 Spec-
	      ify 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.	 With-
	      out  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	exten-
	      sions that represent them.

	      Default: /etc/mime.types

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

       --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.67.0				 Sep 02, 2025			    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.0>

home | help