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.

       --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