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.65.0-DEV			 Jan 12, 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+14.3.quarterly>

home | help